@compozy/cli 0.3.0-beta.2 → 0.3.0-beta.4
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 +42 -27
- package/package.json +9 -9
package/README.md
CHANGED
|
@@ -45,14 +45,14 @@ 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
|
-
- **Built to extend.** Agents, skills, capabilities,
|
|
48
|
+
- **Built to extend.** Agents, skills, capabilities, hooks, bridges, and extension kits plug into
|
|
49
49
|
explicit runtime contracts.
|
|
50
50
|
- **Compozy Network.** Sessions can discover peers, exchange typed messages, delegate work, and close
|
|
51
51
|
it with receipts over `compozy-network/v0`.
|
|
52
52
|
|
|
53
53
|
## 📦 Installation
|
|
54
54
|
|
|
55
|
-
The documented beta is `v0.3.0-beta.
|
|
55
|
+
The documented beta is `v0.3.0-beta.2`. Homebrew continues to serve the deprecated v0.2 line during
|
|
56
56
|
the beta window and is intentionally omitted here. The `compozy` formula returns with v0.3.0 stable.
|
|
57
57
|
|
|
58
58
|
#### Verified installer
|
|
@@ -75,7 +75,7 @@ npm install -g @compozy/cli@beta
|
|
|
75
75
|
Go's `@latest` still resolves the v0.2 stable line while v0.3 is in beta, so use the explicit version:
|
|
76
76
|
|
|
77
77
|
```bash
|
|
78
|
-
go install github.com/compozy/compozy@v0.3.0-beta.
|
|
78
|
+
go install github.com/compozy/compozy@v0.3.0-beta.2
|
|
79
79
|
```
|
|
80
80
|
|
|
81
81
|
#### From Source
|
|
@@ -86,7 +86,7 @@ cd compozy
|
|
|
86
86
|
go build -o ./bin/compozy .
|
|
87
87
|
```
|
|
88
88
|
|
|
89
|
-
The [installation guide](https://compozy.com/
|
|
89
|
+
The [installation guide](https://compozy.com/docs/getting-started/installation) covers
|
|
90
90
|
installer flags, Linux packages, source builds, verification, and managed updates.
|
|
91
91
|
|
|
92
92
|
## 🔄 How It Works
|
|
@@ -102,7 +102,8 @@ parallel model.
|
|
|
102
102
|
|
|
103
103
|
### Daemon Runtime Model
|
|
104
104
|
|
|
105
|
-
`compozy daemon start
|
|
105
|
+
`compozy daemon start`, `compozy status`, and `compozy daemon stop` manage the local daemon.
|
|
106
|
+
Sessions, tasks, Loop runs, memory,
|
|
106
107
|
automation, tools, and Compozy Network activity keep explicit owners and workspace boundaries. Use
|
|
107
108
|
structured CLI output (`-o json`), HTTP/SSE, UDS, MCP, or native tools when another agent or program
|
|
108
109
|
needs to manage the same resources.
|
|
@@ -126,7 +127,7 @@ compozy config show -o json
|
|
|
126
127
|
```
|
|
127
128
|
|
|
128
129
|
Configuration, credentials, and provider-home policies have different owners. Follow the
|
|
129
|
-
[configuration guide](https://compozy.com/
|
|
130
|
+
[configuration guide](https://compozy.com/docs/configuration/config-toml) instead of copying
|
|
130
131
|
v0.2 state into a v0.3 home.
|
|
131
132
|
|
|
132
133
|
## Reusable Agents
|
|
@@ -137,51 +138,65 @@ definitions as a whole.
|
|
|
137
138
|
|
|
138
139
|
```bash
|
|
139
140
|
compozy agent list -o json
|
|
140
|
-
compozy agent
|
|
141
|
-
compozy session new --
|
|
141
|
+
compozy agent info general -o json
|
|
142
|
+
compozy session new --agent general
|
|
142
143
|
```
|
|
143
144
|
|
|
144
145
|
## 🔌 Extensions
|
|
145
146
|
|
|
146
|
-
Extensions add versioned resources and runtime behavior through declared
|
|
147
|
+
Extensions add versioned resources and runtime behavior through declared provide surfaces. The daemon
|
|
147
148
|
owns discovery, enablement, trust decisions, lifecycle, and hooks; extensions do not bypass public
|
|
148
149
|
runtime contracts.
|
|
149
150
|
|
|
151
|
+
### Build one in three commands
|
|
152
|
+
|
|
153
|
+
```bash
|
|
154
|
+
compozy extension init hello --template tool-provider-go
|
|
155
|
+
compozy extension dev hello
|
|
156
|
+
compozy tool invoke ext__hello__search --workspace . --input '{"query":"compozy"}'
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
Authoring is code-first: you declare the tool once in code and `compozy extension build` generates
|
|
160
|
+
the manifest. Walkthrough:
|
|
161
|
+
[Build your first extension](https://compozy.com/docs/guides/build-your-first-extension).
|
|
162
|
+
|
|
150
163
|
### SDK support
|
|
151
164
|
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
the v0.3 extension contract.
|
|
165
|
+
`@compozy/extension-sdk` (npm, MIT) and `github.com/compozy/compozy/sdk/go` are published and
|
|
166
|
+
version-matched to the daemon.
|
|
155
167
|
|
|
156
168
|
### Extension CLI
|
|
157
169
|
|
|
158
170
|
```bash
|
|
159
171
|
compozy extension list -o json
|
|
160
|
-
compozy extension
|
|
172
|
+
compozy extension status <name> -o json
|
|
161
173
|
compozy extension provenance <name> -o json
|
|
174
|
+
compozy extension logs <name> --follow
|
|
162
175
|
```
|
|
163
176
|
|
|
164
177
|
### Learn more
|
|
165
178
|
|
|
166
|
-
- [
|
|
167
|
-
- [
|
|
179
|
+
- [Build your first extension](https://compozy.com/docs/guides/build-your-first-extension)
|
|
180
|
+
- [Extensions](https://compozy.com/docs/extensions)
|
|
181
|
+
- [Publish an extension](https://compozy.com/docs/extensions/publish)
|
|
182
|
+
- [Capabilities and extension kits](https://compozy.com/docs/extensions)
|
|
168
183
|
- [Official Compozy skill](skills/compozy/)
|
|
169
184
|
- [Migration guide](MIGRATION_GUIDE.md)
|
|
170
185
|
|
|
171
186
|
## 🚀 Quick Start
|
|
172
187
|
|
|
173
|
-
Bootstrap the home, start the daemon,
|
|
174
|
-
|
|
188
|
+
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
|
|
190
|
+
`--workspace <id|name|path>` only when you need an override.
|
|
175
191
|
|
|
176
192
|
```bash
|
|
177
193
|
compozy install
|
|
178
194
|
compozy daemon start
|
|
179
|
-
compozy
|
|
180
|
-
compozy session new --workspace current --agent general
|
|
195
|
+
compozy session new --agent general --name first-run
|
|
181
196
|
```
|
|
182
197
|
|
|
183
|
-
The [Quick Start](https://compozy.com/
|
|
184
|
-
first prompt, inspection, and
|
|
198
|
+
The [Quick Start](https://compozy.com/docs/getting-started/quick-start) continues through the
|
|
199
|
+
first prompt, live attachment, inspection, and cleanup.
|
|
185
200
|
|
|
186
201
|
## 🧩 Skills
|
|
187
202
|
|
|
@@ -204,12 +219,12 @@ artifacts; they are not imported as hidden runtime state.
|
|
|
204
219
|
|
|
205
220
|
Compozy runs ACP-compatible agent CLIs and adapters. The active provider catalog and each agent's
|
|
206
221
|
runtime settings are runtime truth; inspect them before selecting a model or reasoning mode. See the
|
|
207
|
-
[provider guide](https://compozy.com/
|
|
222
|
+
[provider guide](https://compozy.com/docs/agents/providers) for authentication and
|
|
208
223
|
provider-home policies.
|
|
209
224
|
|
|
210
225
|
## 📖 CLI Reference
|
|
211
226
|
|
|
212
|
-
The generated [CLI reference](https://compozy.com/
|
|
227
|
+
The generated [CLI reference](https://compozy.com/docs/cli-reference) is authoritative for verbs,
|
|
213
228
|
flags, structured output, and exit behavior. Start with:
|
|
214
229
|
|
|
215
230
|
```bash
|
|
@@ -220,11 +235,11 @@ compozy doctor -o json
|
|
|
220
235
|
|
|
221
236
|
## Documentation
|
|
222
237
|
|
|
223
|
-
- [Runtime overview](https://compozy.com/
|
|
224
|
-
- [Installation](https://compozy.com/
|
|
225
|
-
- [Quick Start](https://compozy.com/
|
|
238
|
+
- [Runtime overview](https://compozy.com/docs)
|
|
239
|
+
- [Installation](https://compozy.com/docs/getting-started/installation)
|
|
240
|
+
- [Quick Start](https://compozy.com/docs/getting-started/quick-start)
|
|
226
241
|
- [Migrate from v0.2.15](MIGRATION_GUIDE.md)
|
|
227
|
-
- [CLI reference](https://compozy.com/
|
|
242
|
+
- [CLI reference](https://compozy.com/docs/cli-reference)
|
|
228
243
|
- [Compozy Network protocol](https://compozy.com/protocol)
|
|
229
244
|
- [GitHub releases](https://github.com/compozy/compozy/releases)
|
|
230
245
|
|
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.4",
|
|
5
5
|
"description": "A local-first operating system for agent work.",
|
|
6
6
|
"scripts": {
|
|
7
7
|
"postinstall": "node install.js",
|
|
@@ -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.4/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": "d4a6a13bc26329e6b0c58240cff200df94df55a50a4a0161fba0b03164ec47e9"
|
|
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.4/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": "eb5dcb88df8b7e9d7f666722d74125eb028939f694bbd2649ac687c148b8ac7e"
|
|
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.4/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": "28b09eaa0c63b71633411b7ebad2bf206ca024aa864a9f4f1932ea32bb2f0c49"
|
|
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.4/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": "cf7e2b18b6933955440f07fdc8ba5001697e372e25034e81a400321703c97ae0"
|
|
75
75
|
}
|
|
76
76
|
}
|
|
77
77
|
}
|