@compozy/cli 0.3.0-beta.3 → 0.3.0-beta.30
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +72 -34
- package/install.js +0 -0
- package/package.json +11 -11
package/README.md
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
<div align="center">
|
|
2
|
-
<img src="packages/site/public/icon-512.png" alt="
|
|
2
|
+
<img src="packages/site/public/icon-512.png" alt="CompozyOS" width="96" height="96">
|
|
3
3
|
<h1>CompozyOS</h1>
|
|
4
|
-
<p><strong>
|
|
4
|
+
<p><strong>The system around the agent, already built.</strong></p>
|
|
5
|
+
<p>An operating system for AI agents.</p>
|
|
5
6
|
<p>
|
|
6
7
|
<a href="https://github.com/compozy/compozy/actions/workflows/ci.yml">
|
|
7
8
|
<img src="https://github.com/compozy/compozy/actions/workflows/ci.yml/badge.svg" alt="CI">
|
|
@@ -21,10 +22,11 @@
|
|
|
21
22
|
</p>
|
|
22
23
|
</div>
|
|
23
24
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
25
|
+
Anyone can prompt an agent. Making agents work continuously is still an engineering project: loops,
|
|
26
|
+
triggers, cron, memory, permissions, approvals, observability, and the glue scripts that hold them
|
|
27
|
+
together. CompozyOS turns that entire agent stack into one product, a complete environment to
|
|
28
|
+
create, automate, and supervise agent work with the agent CLIs you already use (Claude Code,
|
|
29
|
+
OpenClaw, and Hermes). Built first for developers and technical operators.
|
|
28
30
|
|
|
29
31
|
> [!WARNING]
|
|
30
32
|
> The v0.3 line is in beta. The previous v0.2.15 product is deprecated and maintained only for
|
|
@@ -32,32 +34,38 @@ surfaces.
|
|
|
32
34
|
> the [migration guide](MIGRATION_GUIDE.md) before replacing an existing v0.2 installation.
|
|
33
35
|
|
|
34
36
|
<div align="center">
|
|
35
|
-
<img src="imgs/screenshot.png" alt="CompozyOS
|
|
37
|
+
<img src="imgs/screenshot.png" alt="CompozyOS web shell" width="100%">
|
|
36
38
|
</div>
|
|
37
39
|
|
|
38
40
|
## ✨ Highlights
|
|
39
41
|
|
|
42
|
+
- **Create.** Sessions, agents, Loops, and capabilities are objects you author once and reuse, not
|
|
43
|
+
scripts you rewrite per run.
|
|
44
|
+
- **Automate.** Cron schedules, webhooks, and triggers keep work running with no terminal open.
|
|
45
|
+
- **Supervise.** Approvals, permissions, run state, artifacts, and agent activity stay inspectable
|
|
46
|
+
while work continues in the background.
|
|
40
47
|
- **Work survives the terminal.** Sessions and Loop runs belong to the daemon, so closing one client
|
|
41
48
|
does not erase the work.
|
|
42
|
-
- **
|
|
43
|
-
same
|
|
44
|
-
- **
|
|
45
|
-
|
|
49
|
+
- **Runs the agents you already use.** ACP-compatible CLIs (Claude Code, OpenClaw, and Hermes)
|
|
50
|
+
operate the same daemon-owned state.
|
|
51
|
+
- **Batteries included.** One runtime, one state model: loops, approvals, and memory are core
|
|
52
|
+
objects, not plugins, reachable from web, CLI, HTTP/SSE, UDS, MCP, and native tools.
|
|
46
53
|
- **Local-first by default.** One Go binary and SQLite-backed stores keep runtime state on the
|
|
47
54
|
operator's machine unless a configured provider or extension owns an external boundary.
|
|
48
|
-
- **
|
|
55
|
+
- **Remote access stays explicit.** The [Gateway](https://compozy.com/docs/gateway)
|
|
56
|
+
pairs devices and exposes only the private or public surfaces an operator enables.
|
|
57
|
+
- **Built to extend.** Agents, skills, capabilities, hooks, and extension kits plug into
|
|
49
58
|
explicit runtime contracts.
|
|
50
|
-
- **Compozy Network.** Sessions can discover peers, exchange typed messages, delegate work, and close
|
|
51
|
-
it with receipts over `compozy-network/v0`.
|
|
52
59
|
|
|
53
60
|
## 📦 Installation
|
|
54
61
|
|
|
55
|
-
The
|
|
56
|
-
the beta window and is intentionally omitted here. The `compozy` formula returns with v0.3.0
|
|
62
|
+
The v0.3 beta ships through the channels below. Homebrew continues to serve the deprecated v0.2 line
|
|
63
|
+
during the beta window and is intentionally omitted here. The `compozy` formula returns with v0.3.0
|
|
64
|
+
stable.
|
|
57
65
|
|
|
58
66
|
#### Verified installer
|
|
59
67
|
|
|
60
|
-
The installer
|
|
68
|
+
The installer pins the latest published beta and verifies Sigstore provenance before installing the
|
|
61
69
|
binary on macOS or Linux.
|
|
62
70
|
|
|
63
71
|
```bash
|
|
@@ -72,10 +80,11 @@ npm install -g @compozy/cli@beta
|
|
|
72
80
|
|
|
73
81
|
#### Go
|
|
74
82
|
|
|
75
|
-
Go's `@latest` still resolves the v0.2 stable line while v0.3 is in beta, so
|
|
83
|
+
Go's `@latest` still resolves the v0.2 stable line while v0.3 is in beta, so install with the
|
|
84
|
+
explicit tag shown on the [latest release](https://github.com/compozy/compozy/releases/latest):
|
|
76
85
|
|
|
77
86
|
```bash
|
|
78
|
-
go install github.com/compozy/compozy
|
|
87
|
+
go install github.com/compozy/compozy@<release-tag>
|
|
79
88
|
```
|
|
80
89
|
|
|
81
90
|
#### From Source
|
|
@@ -104,7 +113,7 @@ parallel model.
|
|
|
104
113
|
|
|
105
114
|
`compozy daemon start`, `compozy status`, and `compozy daemon stop` manage the local daemon.
|
|
106
115
|
Sessions, tasks, Loop runs, memory,
|
|
107
|
-
automation
|
|
116
|
+
automation and tools keep explicit owners and workspace boundaries. Use
|
|
108
117
|
structured CLI output (`-o json`), HTTP/SSE, UDS, MCP, or native tools when another agent or program
|
|
109
118
|
needs to manage the same resources.
|
|
110
119
|
|
|
@@ -156,8 +165,9 @@ compozy extension dev hello
|
|
|
156
165
|
compozy tool invoke ext__hello__search --workspace . --input '{"query":"compozy"}'
|
|
157
166
|
```
|
|
158
167
|
|
|
159
|
-
|
|
160
|
-
the manifest.
|
|
168
|
+
Executable extensions are code-first: declare the tool once in code and `compozy extension build`
|
|
169
|
+
generates the manifest. Resource-only extensions can instead hand-write `extension.toml` and use the
|
|
170
|
+
same build, dev, reload, and watch loop without running extension code. Walkthrough:
|
|
161
171
|
[Build your first extension](https://compozy.com/docs/guides/build-your-first-extension).
|
|
162
172
|
|
|
163
173
|
### SDK support
|
|
@@ -179,14 +189,14 @@ compozy extension logs <name> --follow
|
|
|
179
189
|
- [Build your first extension](https://compozy.com/docs/guides/build-your-first-extension)
|
|
180
190
|
- [Extensions](https://compozy.com/docs/extensions)
|
|
181
191
|
- [Publish an extension](https://compozy.com/docs/extensions/publish)
|
|
182
|
-
- [Capabilities and
|
|
183
|
-
- [Official
|
|
192
|
+
- [Capabilities and extension kits](https://compozy.com/docs/extensions)
|
|
193
|
+
- [Official CompozyOS skill](skills/compozy/)
|
|
184
194
|
- [Migration guide](MIGRATION_GUIDE.md)
|
|
185
195
|
|
|
186
196
|
## 🚀 Quick Start
|
|
187
197
|
|
|
188
198
|
Bootstrap the home, start the daemon, enter the repository you want agents to work in, and create one
|
|
189
|
-
durable session.
|
|
199
|
+
durable session. CompozyOS infers and registers the workspace from the current directory; use
|
|
190
200
|
`--workspace <id|name|path>` only when you need an override.
|
|
191
201
|
|
|
192
202
|
```bash
|
|
@@ -217,7 +227,7 @@ artifacts; they are not imported as hidden runtime state.
|
|
|
217
227
|
|
|
218
228
|
### 🤖 Supported Agents
|
|
219
229
|
|
|
220
|
-
|
|
230
|
+
CompozyOS runs ACP-compatible agent CLIs and adapters. The active provider catalog and each agent's
|
|
221
231
|
runtime settings are runtime truth; inspect them before selecting a model or reasoning mode. See the
|
|
222
232
|
[provider guide](https://compozy.com/docs/agents/providers) for authentication and
|
|
223
233
|
provider-home policies.
|
|
@@ -240,7 +250,6 @@ compozy doctor -o json
|
|
|
240
250
|
- [Quick Start](https://compozy.com/docs/getting-started/quick-start)
|
|
241
251
|
- [Migrate from v0.2.15](MIGRATION_GUIDE.md)
|
|
242
252
|
- [CLI reference](https://compozy.com/docs/cli-reference)
|
|
243
|
-
- [Compozy Network protocol](https://compozy.com/protocol)
|
|
244
253
|
- [GitHub releases](https://github.com/compozy/compozy/releases)
|
|
245
254
|
|
|
246
255
|
## 🛠️ Development
|
|
@@ -252,14 +261,43 @@ Vite HMR:
|
|
|
252
261
|
make dev
|
|
253
262
|
```
|
|
254
263
|
|
|
255
|
-
|
|
264
|
+
To populate the Northstar Pay demo and leave its daemon running in the background:
|
|
256
265
|
|
|
257
266
|
```bash
|
|
258
|
-
make
|
|
267
|
+
make demo-seed
|
|
268
|
+
# Optional isolated home and secondary port:
|
|
269
|
+
make demo-seed DEMO_HOME="$HOME/.compozy-demo-other" DEMO_PORT=2125
|
|
259
270
|
```
|
|
260
271
|
|
|
261
|
-
|
|
262
|
-
|
|
272
|
+
This builds the daemon and Web bundle, replaces the seed-owned scenario, and starts
|
|
273
|
+
the demo at `http://localhost:2124` using `~/.compozy-demo` by default. The main
|
|
274
|
+
instance is unchanged. To reseed a running demo, first stop its daemon with
|
|
275
|
+
`COMPOZY_HOME="$HOME/.compozy-demo" ./bin/compozy daemon stop` (use your custom home
|
|
276
|
+
if overridden). The raw `go run ./scripts/demo-seed --home <path>` command remains
|
|
277
|
+
available for data-only seeding. Existing demos in `~/.agh` can still be selected
|
|
278
|
+
explicitly with `DEMO_HOME`.
|
|
279
|
+
|
|
280
|
+
To prepare the same demo and open it in the Electron desktop shell:
|
|
281
|
+
|
|
282
|
+
```bash
|
|
283
|
+
make demo-seed-desktop
|
|
284
|
+
# The same overrides apply:
|
|
285
|
+
make demo-seed-desktop DEMO_HOME="$HOME/.compozy-demo-other" DEMO_PORT=2125
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
The desktop shell uses the demo home for its runtime connection and Electron
|
|
289
|
+
profile. Quitting Electron leaves the demo daemon running in the background.
|
|
290
|
+
As with `demo-seed`, stop an already-running demo before reseeding it.
|
|
291
|
+
|
|
292
|
+
Run the affected local gate before committing or pushing:
|
|
293
|
+
|
|
294
|
+
```bash
|
|
295
|
+
make gate
|
|
296
|
+
```
|
|
297
|
+
|
|
298
|
+
Delivery finishes in the draft PR: wait for every required CI check to pass on its current head.
|
|
299
|
+
|
|
300
|
+
Read [AGENTS.md](AGENTS.md) and the surface-specific instructions before editing.
|
|
263
301
|
|
|
264
302
|
## Star History
|
|
265
303
|
|
|
@@ -274,12 +312,12 @@ Read [AGENTS.md](AGENTS.md), the surface-specific instructions, and the
|
|
|
274
312
|
## 🤝 Contributing
|
|
275
313
|
|
|
276
314
|
Contributions are welcome. Open an issue or pull request, keep public behavior agent-manageable, and
|
|
277
|
-
run `make
|
|
315
|
+
run `make gate` before sending changes, then keep the PR until its current-head CI is green. [Security reports](SECURITY.md) belong in the repository's
|
|
278
316
|
private security channel, not a public issue.
|
|
279
317
|
|
|
280
318
|
## Contributors
|
|
281
319
|
|
|
282
|
-
Thanks to everyone who has contributed to
|
|
320
|
+
Thanks to everyone who has contributed to CompozyOS.
|
|
283
321
|
|
|
284
322
|
<a href="https://github.com/compozy/compozy/graphs/contributors">
|
|
285
323
|
<img src="https://contrib.rocks/image?repo=compozy/compozy" alt="Contributors" />
|
|
@@ -287,4 +325,4 @@ Thanks to everyone who has contributed to Compozy.
|
|
|
287
325
|
|
|
288
326
|
## 📄 License
|
|
289
327
|
|
|
290
|
-
|
|
328
|
+
CompozyOS is distributed under the [MIT License](LICENSE).
|
package/install.js
CHANGED
|
File without changes
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@compozy/cli",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "0.3.0-beta.
|
|
5
|
-
"description": "
|
|
4
|
+
"version": "0.3.0-beta.30",
|
|
5
|
+
"description": "One complete environment to create, automate, and supervise agent work.",
|
|
6
6
|
"scripts": {
|
|
7
7
|
"postinstall": "node install.js",
|
|
8
8
|
"run": "node run-compozy.js"
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"type": "git",
|
|
12
12
|
"url": "git+https://github.com/compozy/compozy.git"
|
|
13
13
|
},
|
|
14
|
-
"author": "
|
|
14
|
+
"author": "CompozyOS Team",
|
|
15
15
|
"license": "MIT",
|
|
16
16
|
"bugs": {
|
|
17
17
|
"url": "https://github.com/compozy/compozy/issues"
|
|
@@ -28,50 +28,50 @@
|
|
|
28
28
|
"archives": {
|
|
29
29
|
"darwin-arm64": {
|
|
30
30
|
"name": "compozy_darwin_arm64.tar.gz",
|
|
31
|
-
"url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.
|
|
31
|
+
"url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.30/compozy_darwin_arm64.tar.gz",
|
|
32
32
|
"bins": [
|
|
33
33
|
"compozy"
|
|
34
34
|
],
|
|
35
35
|
"format": "tar.gz",
|
|
36
36
|
"checksum": {
|
|
37
37
|
"algorithm": "sha256",
|
|
38
|
-
"digest": "
|
|
38
|
+
"digest": "773b87251b71c1129f6fd5227984fdccafff515efccdd5383335054f542dd4fc"
|
|
39
39
|
}
|
|
40
40
|
},
|
|
41
41
|
"darwin-x64": {
|
|
42
42
|
"name": "compozy_darwin_x86_64.tar.gz",
|
|
43
|
-
"url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.
|
|
43
|
+
"url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.30/compozy_darwin_x86_64.tar.gz",
|
|
44
44
|
"bins": [
|
|
45
45
|
"compozy"
|
|
46
46
|
],
|
|
47
47
|
"format": "tar.gz",
|
|
48
48
|
"checksum": {
|
|
49
49
|
"algorithm": "sha256",
|
|
50
|
-
"digest": "
|
|
50
|
+
"digest": "74cbace2dc66e0459f6337cd5b6273154b55f9b3213f192b4f3bd6464f5cffb2"
|
|
51
51
|
}
|
|
52
52
|
},
|
|
53
53
|
"linux-arm64": {
|
|
54
54
|
"name": "compozy_linux_arm64.tar.gz",
|
|
55
|
-
"url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.
|
|
55
|
+
"url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.30/compozy_linux_arm64.tar.gz",
|
|
56
56
|
"bins": [
|
|
57
57
|
"compozy"
|
|
58
58
|
],
|
|
59
59
|
"format": "tar.gz",
|
|
60
60
|
"checksum": {
|
|
61
61
|
"algorithm": "sha256",
|
|
62
|
-
"digest": "
|
|
62
|
+
"digest": "1b0aa0bf009e8385fa1931c90da8d5e00bdf7ffde9661fd5fe3d04c52bed14a5"
|
|
63
63
|
}
|
|
64
64
|
},
|
|
65
65
|
"linux-x64": {
|
|
66
66
|
"name": "compozy_linux_x86_64.tar.gz",
|
|
67
|
-
"url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.
|
|
67
|
+
"url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.30/compozy_linux_x86_64.tar.gz",
|
|
68
68
|
"bins": [
|
|
69
69
|
"compozy"
|
|
70
70
|
],
|
|
71
71
|
"format": "tar.gz",
|
|
72
72
|
"checksum": {
|
|
73
73
|
"algorithm": "sha256",
|
|
74
|
-
"digest": "
|
|
74
|
+
"digest": "c16b2359ac777edd2531b3b2ad49a420b0290775bc79c44a347f941b96c01ef7"
|
|
75
75
|
}
|
|
76
76
|
}
|
|
77
77
|
}
|