@compozy/cli 0.3.0-beta.1 → 0.3.0-beta.11
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 +55 -37
- package/package.json +10 -10
package/README.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
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
4
|
<p><strong>A local-first operating system for agent work.</strong></p>
|
|
5
5
|
<p>
|
|
@@ -45,19 +45,22 @@ surfaces.
|
|
|
45
45
|
inspectable while work continues in the background.
|
|
46
46
|
- **Local-first by default.** One Go binary and SQLite-backed stores keep runtime state on the
|
|
47
47
|
operator's machine unless a configured provider or extension owns an external boundary.
|
|
48
|
-
- **
|
|
48
|
+
- **Remote access stays explicit.** The [Gateway](https://compozy.com/docs/gateway)
|
|
49
|
+
pairs devices and exposes only the private or public surfaces an operator enables.
|
|
50
|
+
- **Built to extend.** Agents, skills, capabilities, hooks, bridges, and extension kits plug into
|
|
49
51
|
explicit runtime contracts.
|
|
50
52
|
- **Compozy Network.** Sessions can discover peers, exchange typed messages, delegate work, and close
|
|
51
53
|
it with receipts over `compozy-network/v0`.
|
|
52
54
|
|
|
53
55
|
## 📦 Installation
|
|
54
56
|
|
|
55
|
-
The
|
|
56
|
-
the beta window and is intentionally omitted here. The `compozy` formula returns with v0.3.0
|
|
57
|
+
The v0.3 beta ships through the channels below. Homebrew continues to serve the deprecated v0.2 line
|
|
58
|
+
during the beta window and is intentionally omitted here. The `compozy` formula returns with v0.3.0
|
|
59
|
+
stable.
|
|
57
60
|
|
|
58
61
|
#### Verified installer
|
|
59
62
|
|
|
60
|
-
The installer
|
|
63
|
+
The installer pins the latest published beta and verifies Sigstore provenance before installing the
|
|
61
64
|
binary on macOS or Linux.
|
|
62
65
|
|
|
63
66
|
```bash
|
|
@@ -72,10 +75,11 @@ npm install -g @compozy/cli@beta
|
|
|
72
75
|
|
|
73
76
|
#### Go
|
|
74
77
|
|
|
75
|
-
Go's `@latest` still resolves the v0.2 stable line while v0.3 is in beta, so
|
|
78
|
+
Go's `@latest` still resolves the v0.2 stable line while v0.3 is in beta, so install with the
|
|
79
|
+
explicit tag shown on the [latest release](https://github.com/compozy/compozy/releases/latest):
|
|
76
80
|
|
|
77
81
|
```bash
|
|
78
|
-
go install github.com/compozy/compozy
|
|
82
|
+
go install github.com/compozy/compozy@<release-tag>
|
|
79
83
|
```
|
|
80
84
|
|
|
81
85
|
#### From Source
|
|
@@ -86,7 +90,7 @@ cd compozy
|
|
|
86
90
|
go build -o ./bin/compozy .
|
|
87
91
|
```
|
|
88
92
|
|
|
89
|
-
The [installation guide](https://compozy.com/
|
|
93
|
+
The [installation guide](https://compozy.com/docs/getting-started/installation) covers
|
|
90
94
|
installer flags, Linux packages, source builds, verification, and managed updates.
|
|
91
95
|
|
|
92
96
|
## 🔄 How It Works
|
|
@@ -102,7 +106,8 @@ parallel model.
|
|
|
102
106
|
|
|
103
107
|
### Daemon Runtime Model
|
|
104
108
|
|
|
105
|
-
`compozy daemon start
|
|
109
|
+
`compozy daemon start`, `compozy status`, and `compozy daemon stop` manage the local daemon.
|
|
110
|
+
Sessions, tasks, Loop runs, memory,
|
|
106
111
|
automation, tools, and Compozy Network activity keep explicit owners and workspace boundaries. Use
|
|
107
112
|
structured CLI output (`-o json`), HTTP/SSE, UDS, MCP, or native tools when another agent or program
|
|
108
113
|
needs to manage the same resources.
|
|
@@ -126,7 +131,7 @@ compozy config show -o json
|
|
|
126
131
|
```
|
|
127
132
|
|
|
128
133
|
Configuration, credentials, and provider-home policies have different owners. Follow the
|
|
129
|
-
[configuration guide](https://compozy.com/
|
|
134
|
+
[configuration guide](https://compozy.com/docs/configuration/config-toml) instead of copying
|
|
130
135
|
v0.2 state into a v0.3 home.
|
|
131
136
|
|
|
132
137
|
## Reusable Agents
|
|
@@ -137,51 +142,65 @@ definitions as a whole.
|
|
|
137
142
|
|
|
138
143
|
```bash
|
|
139
144
|
compozy agent list -o json
|
|
140
|
-
compozy agent
|
|
141
|
-
compozy session new --
|
|
145
|
+
compozy agent info general -o json
|
|
146
|
+
compozy session new --agent general
|
|
142
147
|
```
|
|
143
148
|
|
|
144
149
|
## 🔌 Extensions
|
|
145
150
|
|
|
146
|
-
Extensions add versioned resources and runtime behavior through declared
|
|
151
|
+
Extensions add versioned resources and runtime behavior through declared provide surfaces. The daemon
|
|
147
152
|
owns discovery, enablement, trust decisions, lifecycle, and hooks; extensions do not bypass public
|
|
148
153
|
runtime contracts.
|
|
149
154
|
|
|
155
|
+
### Build one in three commands
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
compozy extension init hello --template tool-provider-go
|
|
159
|
+
compozy extension dev hello
|
|
160
|
+
compozy tool invoke ext__hello__search --workspace . --input '{"query":"compozy"}'
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
Authoring is code-first: you declare the tool once in code and `compozy extension build` generates
|
|
164
|
+
the manifest. Walkthrough:
|
|
165
|
+
[Build your first extension](https://compozy.com/docs/guides/build-your-first-extension).
|
|
166
|
+
|
|
150
167
|
### SDK support
|
|
151
168
|
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
the v0.3 extension contract.
|
|
169
|
+
`@compozy/extension-sdk` (npm, MIT) and `github.com/compozy/compozy/sdk/go` are published and
|
|
170
|
+
version-matched to the daemon.
|
|
155
171
|
|
|
156
172
|
### Extension CLI
|
|
157
173
|
|
|
158
174
|
```bash
|
|
159
175
|
compozy extension list -o json
|
|
160
|
-
compozy extension
|
|
176
|
+
compozy extension status <name> -o json
|
|
161
177
|
compozy extension provenance <name> -o json
|
|
178
|
+
compozy extension logs <name> --follow
|
|
162
179
|
```
|
|
163
180
|
|
|
164
181
|
### Learn more
|
|
165
182
|
|
|
166
|
-
- [
|
|
167
|
-
- [
|
|
168
|
-
- [
|
|
183
|
+
- [Build your first extension](https://compozy.com/docs/guides/build-your-first-extension)
|
|
184
|
+
- [Extensions](https://compozy.com/docs/extensions)
|
|
185
|
+
- [Publish an extension](https://compozy.com/docs/extensions/publish)
|
|
186
|
+
- [Capabilities and extension kits](https://compozy.com/docs/extensions)
|
|
187
|
+
- [Official CompozyOS skill](skills/compozy/)
|
|
169
188
|
- [Migration guide](MIGRATION_GUIDE.md)
|
|
170
189
|
|
|
171
190
|
## 🚀 Quick Start
|
|
172
191
|
|
|
173
|
-
Bootstrap the home, start the daemon,
|
|
174
|
-
|
|
192
|
+
Bootstrap the home, start the daemon, enter the repository you want agents to work in, and create one
|
|
193
|
+
durable session. CompozyOS infers and registers the workspace from the current directory; use
|
|
194
|
+
`--workspace <id|name|path>` only when you need an override.
|
|
175
195
|
|
|
176
196
|
```bash
|
|
177
197
|
compozy install
|
|
178
198
|
compozy daemon start
|
|
179
|
-
compozy
|
|
180
|
-
compozy session new --workspace current --agent general
|
|
199
|
+
compozy session new --agent general --name first-run
|
|
181
200
|
```
|
|
182
201
|
|
|
183
|
-
The [Quick Start](https://compozy.com/
|
|
184
|
-
first prompt, inspection, and
|
|
202
|
+
The [Quick Start](https://compozy.com/docs/getting-started/quick-start) continues through the
|
|
203
|
+
first prompt, live attachment, inspection, and cleanup.
|
|
185
204
|
|
|
186
205
|
## 🧩 Skills
|
|
187
206
|
|
|
@@ -202,14 +221,14 @@ artifacts; they are not imported as hidden runtime state.
|
|
|
202
221
|
|
|
203
222
|
### 🤖 Supported Agents
|
|
204
223
|
|
|
205
|
-
|
|
224
|
+
CompozyOS runs ACP-compatible agent CLIs and adapters. The active provider catalog and each agent's
|
|
206
225
|
runtime settings are runtime truth; inspect them before selecting a model or reasoning mode. See the
|
|
207
|
-
[provider guide](https://compozy.com/
|
|
226
|
+
[provider guide](https://compozy.com/docs/agents/providers) for authentication and
|
|
208
227
|
provider-home policies.
|
|
209
228
|
|
|
210
229
|
## 📖 CLI Reference
|
|
211
230
|
|
|
212
|
-
The generated [CLI reference](https://compozy.com/
|
|
231
|
+
The generated [CLI reference](https://compozy.com/docs/cli-reference) is authoritative for verbs,
|
|
213
232
|
flags, structured output, and exit behavior. Start with:
|
|
214
233
|
|
|
215
234
|
```bash
|
|
@@ -220,11 +239,11 @@ compozy doctor -o json
|
|
|
220
239
|
|
|
221
240
|
## Documentation
|
|
222
241
|
|
|
223
|
-
- [Runtime overview](https://compozy.com/
|
|
224
|
-
- [Installation](https://compozy.com/
|
|
225
|
-
- [Quick Start](https://compozy.com/
|
|
242
|
+
- [Runtime overview](https://compozy.com/docs)
|
|
243
|
+
- [Installation](https://compozy.com/docs/getting-started/installation)
|
|
244
|
+
- [Quick Start](https://compozy.com/docs/getting-started/quick-start)
|
|
226
245
|
- [Migrate from v0.2.15](MIGRATION_GUIDE.md)
|
|
227
|
-
- [CLI reference](https://compozy.com/
|
|
246
|
+
- [CLI reference](https://compozy.com/docs/cli-reference)
|
|
228
247
|
- [Compozy Network protocol](https://compozy.com/protocol)
|
|
229
248
|
- [GitHub releases](https://github.com/compozy/compozy/releases)
|
|
230
249
|
|
|
@@ -243,8 +262,7 @@ Run the full repository gate once the change is ready:
|
|
|
243
262
|
make verify
|
|
244
263
|
```
|
|
245
264
|
|
|
246
|
-
Read [AGENTS.md](AGENTS.md)
|
|
247
|
-
[contribution guide](skills/compozy/references/contributing-to-compozy.md) before editing.
|
|
265
|
+
Read [AGENTS.md](AGENTS.md) and the surface-specific instructions before editing.
|
|
248
266
|
|
|
249
267
|
## Star History
|
|
250
268
|
|
|
@@ -264,7 +282,7 @@ private security channel, not a public issue.
|
|
|
264
282
|
|
|
265
283
|
## Contributors
|
|
266
284
|
|
|
267
|
-
Thanks to everyone who has contributed to
|
|
285
|
+
Thanks to everyone who has contributed to CompozyOS.
|
|
268
286
|
|
|
269
287
|
<a href="https://github.com/compozy/compozy/graphs/contributors">
|
|
270
288
|
<img src="https://contrib.rocks/image?repo=compozy/compozy" alt="Contributors" />
|
|
@@ -272,4 +290,4 @@ Thanks to everyone who has contributed to Compozy.
|
|
|
272
290
|
|
|
273
291
|
## 📄 License
|
|
274
292
|
|
|
275
|
-
|
|
293
|
+
CompozyOS is distributed under the [MIT License](LICENSE).
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@compozy/cli",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "0.3.0-beta.
|
|
4
|
+
"version": "0.3.0-beta.11",
|
|
5
5
|
"description": "A local-first operating system for agent work.",
|
|
6
6
|
"scripts": {
|
|
7
7
|
"postinstall": "node install.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.11/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": "5ee4e74418a25b9ffc0dae227aabdc7598933417e30087f64c0b785c3c2221cd"
|
|
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.11/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": "89044c5c2220d8b7822d7a184d898717cf9f6f9f7ff639f2070edaeb1936ff23"
|
|
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.11/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": "a31c688ef5e943929335cf88c0a74135b73c60ab23c998da3533e0f602d896b1"
|
|
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.11/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": "b26cb0115e9d19176f8d917451dad94fef587ec9fe2f41fe135c79ab48e0bed1"
|
|
75
75
|
}
|
|
76
76
|
}
|
|
77
77
|
}
|