@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.
Files changed (3) hide show
  1. package/README.md +72 -34
  2. package/install.js +0 -0
  3. 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="Compozy" width="96" height="96">
2
+ <img src="packages/site/public/icon-512.png" alt="CompozyOS" width="96" height="96">
3
3
  <h1>CompozyOS</h1>
4
- <p><strong>A local-first operating system for agent work.</strong></p>
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
- CompozyOS gives agent work a durable place to live. One local daemon connects sessions, tasks,
25
- loops, memory, permissions, automation, and tools. People can see and steer the work through the web
26
- shell and CLI; agents operate the same state through structured HTTP, UDS, MCP, and native-tool
27
- surfaces.
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 workspace with durable agent work" width="100%">
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
- - **One state, several control surfaces.** Web, CLI, HTTP/SSE, UDS, MCP, and native tools expose the
43
- same runtime-owned resources.
44
- - **People stay in control.** Approvals, permissions, run state, artifacts, and agent activity remain
45
- inspectable while work continues in the background.
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
- - **Built to extend.** Agents, skills, capabilities, bundles, hooks, bridges, and extensions plug into
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 documented beta is `v0.3.0-beta.2`. Homebrew continues to serve the deprecated v0.2 line during
56
- the beta window and is intentionally omitted here. The `compozy` formula returns with v0.3.0 stable.
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 targets the documented beta and verifies Sigstore provenance before installing the
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 use the explicit version:
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@v0.3.0-beta.2
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, tools, and Compozy Network activity keep explicit owners and workspace boundaries. Use
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
- Authoring is code-first: you declare the tool once in code and `compozy extension build` generates
160
- the manifest. Walkthrough:
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 bundles](https://compozy.com/docs)
183
- - [Official Compozy skill](skills/compozy/)
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. Compozy infers and registers the workspace from the current directory; use
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
- Compozy runs ACP-compatible agent CLIs and adapters. The active provider catalog and each agent's
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
- Run the full repository gate once the change is ready:
264
+ To populate the Northstar Pay demo and leave its daemon running in the background:
256
265
 
257
266
  ```bash
258
- make verify
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
- Read [AGENTS.md](AGENTS.md), the surface-specific instructions, and the
262
- [contribution guide](skills/compozy/references/contributing-to-compozy.md) before editing.
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 verify` before sending changes. [Security reports](SECURITY.md) belong in the repository's
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 Compozy.
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
- Compozy is distributed under the [MIT License](LICENSE).
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.3",
5
- "description": "A local-first operating system for agent work.",
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": "Compozy Team",
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.3/compozy_darwin_arm64.tar.gz",
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": "a9532b8eb6625602dab18d5e20e5b250cfb9a3885092487ded7551c852076cea"
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.3/compozy_darwin_x86_64.tar.gz",
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": "01fd3d722628e88632a471b44c1b942a27bf6eca1a89ccba212074f75312ca5e"
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.3/compozy_linux_arm64.tar.gz",
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": "5d4585fa53110e8535071157175a52d4ce126988c60c9f08406e96cdd2755e24"
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.3/compozy_linux_x86_64.tar.gz",
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": "5bba4bbebc271bad92c09d7e4b23a337f8b5757e50e58e355001eb4e97c1d408"
74
+ "digest": "c16b2359ac777edd2531b3b2ad49a420b0290775bc79c44a347f941b96c01ef7"
75
75
  }
76
76
  }
77
77
  }