@compozy/cli 0.3.0-beta.2 → 0.3.0-beta.21

package/README.md

@@ -1,7 +1,8 @@
 <div align="center">
-  <img src="packages/site/public/icon-512.png" alt="Compozy" width="96" height="96">
+  <img src="packages/site/public/icon-512.png" alt="CompozyOS" width="96" height="96">
   <h1>CompozyOS</h1>
-  <p><strong>A local-first operating system for agent work.</strong></p>
+  <p><strong>The system around the agent, already built.</strong></p>
+  <p>An operating system for AI agents.</p>
   <p>
     <a href="https://github.com/compozy/compozy/actions/workflows/ci.yml">
       <img src="https://github.com/compozy/compozy/actions/workflows/ci.yml/badge.svg" alt="CI">
@@ -21,10 +22,11 @@
   </p>
 </div>
 
-CompozyOS gives agent work a durable place to live. One local daemon connects sessions, tasks,
-loops, memory, permissions, automation, and tools. People can see and steer the work through the web
-shell and CLI; agents operate the same state through structured HTTP, UDS, MCP, and native-tool
-surfaces.
+Anyone can prompt an agent. Making agents work continuously is still an engineering project: loops,
+triggers, cron, memory, permissions, approvals, observability, and the glue scripts that hold them
+together. CompozyOS turns that entire agent stack into one product, a complete environment to
+create, automate, and supervise agent work with the agent CLIs you already use (Claude Code,
+OpenClaw, and Hermes). Built first for developers and technical operators.
 
 > [!WARNING]
 > The v0.3 line is in beta. The previous v0.2.15 product is deprecated and maintained only for
@@ -32,32 +34,40 @@ surfaces.
 > the [migration guide](MIGRATION_GUIDE.md) before replacing an existing v0.2 installation.
 
 <div align="center">
-  <img src="imgs/screenshot.png" alt="CompozyOS workspace with durable agent work" width="100%">
+  <img src="imgs/screenshot.png" alt="CompozyOS web shell" width="100%">
 </div>
 
 ## ✨ Highlights
 
+- **Create.** Sessions, agents, Loops, and capabilities are objects you author once and reuse, not
+  scripts you rewrite per run.
+- **Automate.** Cron schedules, webhooks, and triggers keep work running with no terminal open.
+- **Supervise.** Approvals, permissions, run state, artifacts, and agent activity stay inspectable
+  while work continues in the background.
 - **Work survives the terminal.** Sessions and Loop runs belong to the daemon, so closing one client
   does not erase the work.
-- **One state, several control surfaces.** Web, CLI, HTTP/SSE, UDS, MCP, and native tools expose the
-  same runtime-owned resources.
-- **People stay in control.** Approvals, permissions, run state, artifacts, and agent activity remain
-  inspectable while work continues in the background.
+- **Runs the agents you already use.** ACP-compatible CLIs (Claude Code, OpenClaw, and Hermes)
+  operate the same daemon-owned state.
+- **Batteries included.** One runtime, one state model: loops, approvals, and memory are core
+  objects, not plugins, reachable from web, CLI, HTTP/SSE, UDS, MCP, and native tools.
 - **Local-first by default.** One Go binary and SQLite-backed stores keep runtime state on the
   operator's machine unless a configured provider or extension owns an external boundary.
-- **Built to extend.** Agents, skills, capabilities, bundles, hooks, bridges, and extensions plug into
+- **Remote access stays explicit.** The [Gateway](https://compozy.com/docs/gateway)
+  pairs devices and exposes only the private or public surfaces an operator enables.
+- **Built to extend.** Agents, skills, capabilities, hooks, bridges, and extension kits plug into
   explicit runtime contracts.
 - **Compozy Network.** Sessions can discover peers, exchange typed messages, delegate work, and close
   it with receipts over `compozy-network/v0`.
 
 ## 📦 Installation
 
-The documented beta is `v0.3.0-beta.1`. Homebrew continues to serve the deprecated v0.2 line during
-the beta window and is intentionally omitted here. The `compozy` formula returns with v0.3.0 stable.
+The v0.3 beta ships through the channels below. Homebrew continues to serve the deprecated v0.2 line
+during the beta window and is intentionally omitted here. The `compozy` formula returns with v0.3.0
+stable.
 
 #### Verified installer
 
-The installer targets the documented beta and verifies Sigstore provenance before installing the
+The installer pins the latest published beta and verifies Sigstore provenance before installing the
 binary on macOS or Linux.
 
 ```bash
@@ -72,10 +82,11 @@ npm install -g @compozy/cli@beta
 
 #### Go
 
-Go's `@latest` still resolves the v0.2 stable line while v0.3 is in beta, so use the explicit version:
+Go's `@latest` still resolves the v0.2 stable line while v0.3 is in beta, so install with the
+explicit tag shown on the [latest release](https://github.com/compozy/compozy/releases/latest):
 
 ```bash
-go install github.com/compozy/compozy@v0.3.0-beta.1
+go install github.com/compozy/compozy@<release-tag>
 ```
 
 #### From Source
@@ -86,7 +97,7 @@ cd compozy
 go build -o ./bin/compozy .
 ```
 
-The [installation guide](https://compozy.com/runtime/core/getting-started/installation) covers
+The [installation guide](https://compozy.com/docs/getting-started/installation) covers
 installer flags, Linux packages, source builds, verification, and managed updates.
 
 ## 🔄 How It Works
@@ -102,7 +113,8 @@ parallel model.
 
 ### Daemon Runtime Model
 
-`compozy daemon start|status|stop` manages the local daemon. Sessions, tasks, Loop runs, memory,
+`compozy daemon start`, `compozy status`, and `compozy daemon stop` manage the local daemon.
+Sessions, tasks, Loop runs, memory,
 automation, tools, and Compozy Network activity keep explicit owners and workspace boundaries. Use
 structured CLI output (`-o json`), HTTP/SSE, UDS, MCP, or native tools when another agent or program
 needs to manage the same resources.
@@ -126,7 +138,7 @@ compozy config show -o json
 ```
 
 Configuration, credentials, and provider-home policies have different owners. Follow the
-[configuration guide](https://compozy.com/runtime/core/configuration/config-toml) instead of copying
+[configuration guide](https://compozy.com/docs/configuration/config-toml) instead of copying
 v0.2 state into a v0.3 home.
 
 ## Reusable Agents
@@ -137,51 +149,66 @@ definitions as a whole.
 
 ```bash
 compozy agent list -o json
-compozy agent inspect general -o json
-compozy session new --workspace current --agent general
+compozy agent info general -o json
+compozy session new --agent general
 ```
 
 ## 🔌 Extensions
 
-Extensions add versioned resources and runtime behavior through declared capabilities. The daemon
+Extensions add versioned resources and runtime behavior through declared provide surfaces. The daemon
 owns discovery, enablement, trust decisions, lifecycle, and hooks; extensions do not bypass public
 runtime contracts.
 
+### Build one in three commands
+
+```bash
+compozy extension init hello --template tool-provider-go
+compozy extension dev hello
+compozy tool invoke ext__hello__search --workspace . --input '{"query":"compozy"}'
+```
+
+Executable extensions are code-first: declare the tool once in code and `compozy extension build`
+generates the manifest. Resource-only extensions can instead hand-write `extension.toml` and use the
+same build, dev, reload, and watch loop without running extension code. Walkthrough:
+[Build your first extension](https://compozy.com/docs/guides/build-your-first-extension).
+
 ### SDK support
 
-The current Go and TypeScript SDK workspaces are version-matched repository internals, not v0.2
-compatibility packages. External v0.2 integrations should stay pinned while they are redesigned for
-the v0.3 extension contract.
+`@compozy/extension-sdk` (npm, MIT) and `github.com/compozy/compozy/sdk/go` are published and
+version-matched to the daemon.
 
 ### Extension CLI
 
 ```bash
 compozy extension list -o json
-compozy extension inspect <name> -o json
+compozy extension status <name> -o json
 compozy extension provenance <name> -o json
+compozy extension logs <name> --follow
 ```
 
 ### Learn more
 
-- [Extensions](https://compozy.com/runtime/core/extensions)
-- [Capabilities and bundles](https://compozy.com/runtime)
-- [Official Compozy skill](skills/compozy/)
+- [Build your first extension](https://compozy.com/docs/guides/build-your-first-extension)
+- [Extensions](https://compozy.com/docs/extensions)
+- [Publish an extension](https://compozy.com/docs/extensions/publish)
+- [Capabilities and extension kits](https://compozy.com/docs/extensions)
+- [Official CompozyOS skill](skills/compozy/)
 - [Migration guide](MIGRATION_GUIDE.md)
 
 ## 🚀 Quick Start
 
-Bootstrap the home, start the daemon, register the repository you want agents to work in, and create
-one durable session:
+Bootstrap the home, start the daemon, enter the repository you want agents to work in, and create one
+durable session. CompozyOS infers and registers the workspace from the current directory; use
+`--workspace <id|name|path>` only when you need an override.
 
 ```bash
 compozy install
 compozy daemon start
-compozy workspace add "$PWD" --name current
-compozy session new --workspace current --agent general
+compozy session new --agent general --name first-run
 ```
 
-The [Quick Start](https://compozy.com/runtime/core/getting-started/quick-start) continues through the
-first prompt, inspection, and stop/resume flow.
+The [Quick Start](https://compozy.com/docs/getting-started/quick-start) continues through the
+first prompt, live attachment, inspection, and cleanup.
 
 ## 🧩 Skills
 
@@ -202,14 +229,14 @@ artifacts; they are not imported as hidden runtime state.
 
 ### 🤖 Supported Agents
 
-Compozy runs ACP-compatible agent CLIs and adapters. The active provider catalog and each agent's
+CompozyOS runs ACP-compatible agent CLIs and adapters. The active provider catalog and each agent's
 runtime settings are runtime truth; inspect them before selecting a model or reasoning mode. See the
-[provider guide](https://compozy.com/runtime/core/agents/providers) for authentication and
+[provider guide](https://compozy.com/docs/agents/providers) for authentication and
 provider-home policies.
 
 ## 📖 CLI Reference
 
-The generated [CLI reference](https://compozy.com/runtime/cli-reference) is authoritative for verbs,
+The generated [CLI reference](https://compozy.com/docs/cli-reference) is authoritative for verbs,
 flags, structured output, and exit behavior. Start with:
 
 ```bash
@@ -220,11 +247,11 @@ compozy doctor -o json
 
 ## Documentation
 
-- [Runtime overview](https://compozy.com/runtime)
-- [Installation](https://compozy.com/runtime/core/getting-started/installation)
-- [Quick Start](https://compozy.com/runtime/core/getting-started/quick-start)
+- [Runtime overview](https://compozy.com/docs)
+- [Installation](https://compozy.com/docs/getting-started/installation)
+- [Quick Start](https://compozy.com/docs/getting-started/quick-start)
 - [Migrate from v0.2.15](MIGRATION_GUIDE.md)
-- [CLI reference](https://compozy.com/runtime/cli-reference)
+- [CLI reference](https://compozy.com/docs/cli-reference)
 - [Compozy Network protocol](https://compozy.com/protocol)
 - [GitHub releases](https://github.com/compozy/compozy/releases)
 
@@ -237,14 +264,15 @@ Vite HMR:
 make dev
 ```
 
-Run the full repository gate once the change is ready:
+Run the affected local gate before committing or pushing:
 
 ```bash
-make verify
+make gate
 ```
 
-Read [AGENTS.md](AGENTS.md), the surface-specific instructions, and the
-[contribution guide](skills/compozy/references/contributing-to-compozy.md) before editing.
+Delivery finishes in the draft PR: wait for every required CI check to pass on its current head.
+
+Read [AGENTS.md](AGENTS.md) and the surface-specific instructions before editing.
 
 ## Star History
 
@@ -259,12 +287,12 @@ Read [AGENTS.md](AGENTS.md), the surface-specific instructions, and the
 ## 🤝 Contributing
 
 Contributions are welcome. Open an issue or pull request, keep public behavior agent-manageable, and
-run `make verify` before sending changes. [Security reports](SECURITY.md) belong in the repository's
+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
 private security channel, not a public issue.
 
 ## Contributors
 
-Thanks to everyone who has contributed to Compozy.
+Thanks to everyone who has contributed to CompozyOS.
 
 <a href="https://github.com/compozy/compozy/graphs/contributors">
   <img src="https://contrib.rocks/image?repo=compozy/compozy" alt="Contributors" />
@@ -272,4 +300,4 @@ Thanks to everyone who has contributed to Compozy.
 
 ## 📄 License
 
-Compozy is distributed under the [MIT License](LICENSE).
+CompozyOS is distributed under the [MIT License](LICENSE).

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@compozy/cli",
   "type": "module",
-  "version": "0.3.0-beta.2",
-  "description": "A local-first operating system for agent work.",
+  "version": "0.3.0-beta.21",
+  "description": "One complete environment to create, automate, and supervise agent work.",
   "scripts": {
     "postinstall": "node install.js",
     "run": "node run-compozy.js"
@@ -11,7 +11,7 @@
     "type": "git",
     "url": "git+https://github.com/compozy/compozy.git"
   },
-  "author": "Compozy Team",
+  "author": "CompozyOS Team",
   "license": "MIT",
   "bugs": {
     "url": "https://github.com/compozy/compozy/issues"
@@ -28,50 +28,50 @@
   "archives": {
     "darwin-arm64": {
       "name": "compozy_darwin_arm64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.2/compozy_darwin_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.21/compozy_darwin_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "5436b4034861137a420741a8376b04fc6a2c2dec18f4e059de09f6d98ffc6c60"
+        "digest": "1fc18fb514b8e66dd948a3ea9c6cb5c622f7b8351dec19d7cf87d400362909f7"
       }
     },
     "darwin-x64": {
       "name": "compozy_darwin_x86_64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.2/compozy_darwin_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.21/compozy_darwin_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "cb9b2386df9932441ddc3c1425e42ba6b523510cbafac22d93f5b587f3b58a4d"
+        "digest": "38dcd1f881120f5d1f6ed5edae081536d1910edbbf2978b12f732d92a92ea7b1"
       }
     },
     "linux-arm64": {
       "name": "compozy_linux_arm64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.2/compozy_linux_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.21/compozy_linux_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "acde38ee68a3e6b08d45b32245d734bb7203b1fa265db1f48c2d72ca1c46c615"
+        "digest": "6f64daec7abbede4e20ae973c71b7330d2d714554ed343716dca5c3665a8357f"
       }
     },
     "linux-x64": {
       "name": "compozy_linux_x86_64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.2/compozy_linux_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.21/compozy_linux_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "1800f967a3c7438685806f8d537e960848dc4cd6265ac6fe155a295bd027e16e"
+        "digest": "f68714f0ce79d99e7955f24eff6ea4a67f02e594c0f8b6cf1188de11ddfd8d9f"
       }
     }
   }