# How to use these docs URL: https://compozy.com/docs/how-to-use-these-docs Choose the right CompozyOS docs path for learning, operating, extending, and integrating with the daemon. --- # CompozyOS documentation URL: https://compozy.com/docs The system around the agent, already built. What comes built in, and where to start for your job. --- # Agent Capabilities URL: https://compozy.com/docs/agents/capabilities Author capability catalogs, validate supported layouts, and understand how CompozyOS projects each capability into discovery and transfer. --- # Agent Definitions URL: https://compozy.com/docs/agents/definitions The current AGENT.md format, discovery order, runtime defaults, and parser edge cases used by CompozyOS. --- # Agent Heartbeat URL: https://compozy.com/docs/agents/heartbeat Optional HEARTBEAT.md authored wake/reentry policy plus runtime session health, advisory wake decisions, and managed authoring surfaces. --- # Agents URL: https://compozy.com/docs/agents How CompozyOS resolves agent definitions, advertises capabilities, launches providers, and supervises ACP subprocesses. --- # Provider Model Catalog URL: https://compozy.com/docs/agents/model-catalog Daemon-owned model catalog — sources, refresh lifecycle, native HTTP/UDS endpoints, OpenAI-compatible projection, and extension model.source contract. --- # Providers URL: https://compozy.com/docs/agents/providers Built-in provider IDs, launch commands, config overrides, and custom provider setup for CompozyOS agents. --- # Agent Soul URL: https://compozy.com/docs/agents/soul Optional SOUL.md authored persona artifact that CompozyOS resolves, validates, snapshots, and projects into prompts and read models. --- # Spawning URL: https://compozy.com/docs/agents/spawning How CompozyOS resolves an agent definition into an ACP subprocess, negotiates a session, injects environment, and stops the process. --- # Automation URL: https://compozy.com/docs/automation Run CompozyOS agents on schedules, in response to runtime events, or from signed external HTTP requests. --- # Jobs and Scheduling URL: https://compozy.com/docs/automation/jobs Define scheduled CompozyOS automation jobs with cron, interval, and one-time schedules, then monitor runs and retries. --- # Automation Suggestions URL: https://compozy.com/docs/automation/suggestions Review workspace-scoped Job proposals, create the useful ones, and durably dismiss the rest. --- # Triggers URL: https://compozy.com/docs/automation/triggers Configure CompozyOS automation triggers that react to runtime events, filters, and prompt templates. --- # Webhooks URL: https://compozy.com/docs/automation/webhooks Set up signed CompozyOS webhook triggers for CI, deployment, and external event integrations. --- # Task-Run Coordination Conversations URL: https://compozy.com/docs/autonomy/coordination-channels How future coordinated task runs opt into bounded Live conversations without moving task ownership into Network. --- # Coordinator Handoff URL: https://compozy.com/docs/autonomy/coordinator When CompozyOS starts a workspace coordinator and why coordinator bootstrap is independent from Network participation. --- # Task Execution Profiles URL: https://compozy.com/docs/autonomy/execution-profiles Typed task-owned overlays for coordinator guidance, worker selection, reviewer routing, Local or Live participation, sandbox mode, and runtime evidence. --- # Autonomy URL: https://compozy.com/docs/autonomy Explicit operator control, coordinator handoff, task leases, optional Live coordination conversations, and safe spawn. --- # Notification Cursors URL: https://compozy.com/docs/autonomy/notification-cursors Bridge terminal task notifications, durable cursor diagnostics, replay semantics, and SSE reconnect seeding. --- # Notification Presets URL: https://compozy.com/docs/autonomy/notification-presets SQLite-backed notification fanout presets, cursor replay, filters, and bridge suppression. --- # Review Gate URL: https://compozy.com/docs/autonomy/review-gate Post-terminal review of task runs, reviewer routing, persisted verdicts, continuation runs, and the runtime authority boundary. --- # Safe Spawn URL: https://compozy.com/docs/autonomy/safe-spawn How agent-initiated child sessions are bounded by lineage, TTL, caps, workspace inheritance, and permission narrowing. --- # Task Runs and Leases URL: https://compozy.com/docs/autonomy/task-runs-and-leases How agents claim work, renew leases, finish runs, and release session-bound ownership safely. --- # Agent URL: https://compozy.com/docs/api/agent CompozyOS Agent HTTP endpoints. --- # Agents URL: https://compozy.com/docs/api/agents CompozyOS Agents HTTP endpoints. --- # Automation URL: https://compozy.com/docs/api/automation CompozyOS Automation HTTP endpoints. --- # Bridges URL: https://compozy.com/docs/api/bridges CompozyOS Bridges HTTP endpoints. --- # Diagnostics URL: https://compozy.com/docs/api/diagnostics CompozyOS Diagnostics HTTP endpoints. --- # Extensions URL: https://compozy.com/docs/api/extensions CompozyOS Extensions HTTP endpoints. --- # Filesystem URL: https://compozy.com/docs/api/filesystem CompozyOS Filesystem HTTP endpoints. --- # Gateway URL: https://compozy.com/docs/api/gateway CompozyOS Gateway HTTP endpoints. --- # Hooks URL: https://compozy.com/docs/api/hooks CompozyOS Hooks HTTP endpoints. --- # API Reference URL: https://compozy.com/docs/api Per-tag HTTP and SSE reference for the CompozyOS daemon, generated from the canonical OpenAPI contract on every site build. --- # Logs URL: https://compozy.com/docs/api/logs CompozyOS Logs HTTP endpoints. --- # Loops URL: https://compozy.com/docs/api/loops CompozyOS Loops HTTP endpoints. --- # Marketplace URL: https://compozy.com/docs/api/marketplace CompozyOS Marketplace HTTP endpoints. --- # Memory URL: https://compozy.com/docs/api/memory CompozyOS Memory HTTP endpoints. --- # Network URL: https://compozy.com/docs/api/network CompozyOS Network HTTP endpoints. --- # Notifications URL: https://compozy.com/docs/api/notifications CompozyOS Notifications HTTP endpoints. --- # Observe URL: https://compozy.com/docs/api/observe CompozyOS Observe HTTP endpoints. --- # Onboarding URL: https://compozy.com/docs/api/onboarding CompozyOS Onboarding HTTP endpoints. --- # Openai URL: https://compozy.com/docs/api/openai CompozyOS Openai HTTP endpoints. --- # Providers URL: https://compozy.com/docs/api/providers CompozyOS Providers HTTP endpoints. --- # Resources URL: https://compozy.com/docs/api/resources CompozyOS Resources HTTP endpoints. --- # Roles URL: https://compozy.com/docs/api/roles CompozyOS Roles HTTP endpoints. --- # Sessions URL: https://compozy.com/docs/api/sessions CompozyOS Sessions HTTP endpoints. --- # Settings URL: https://compozy.com/docs/api/settings CompozyOS Settings HTTP endpoints. --- # Skills URL: https://compozy.com/docs/api/skills CompozyOS Skills HTTP endpoints. --- # Support URL: https://compozy.com/docs/api/support CompozyOS Support HTTP endpoints. --- # Tasks URL: https://compozy.com/docs/api/tasks CompozyOS Tasks HTTP endpoints. --- # Tools URL: https://compozy.com/docs/api/tools CompozyOS Tools HTTP endpoints. --- # Toolsets URL: https://compozy.com/docs/api/toolsets CompozyOS Toolsets HTTP endpoints. --- # Vault URL: https://compozy.com/docs/api/vault CompozyOS Vault HTTP endpoints. --- # Workspaces URL: https://compozy.com/docs/api/workspaces CompozyOS Workspaces HTTP endpoints. --- # Worktrees URL: https://compozy.com/docs/api/worktrees CompozyOS Worktrees HTTP endpoints. --- # Implement-tasks loop URL: https://compozy.com/docs/examples/implement-tasks-loop Implement every authored task under one slug in dependency order, with task-level validation and tracking updates. --- # Examples URL: https://compozy.com/docs/examples Runnable CompozyOS artifacts — Loops, jobs, webhooks, and triggers you can copy as shipped, run against a current release, and adapt. --- # Morning briefing job URL: https://compozy.com/docs/examples/morning-briefing-job A cron job that wakes an agent every weekday morning, has it read the state of your workspace, and leaves a written briefing waiting for you. --- # Orchestrate-tasks loop URL: https://compozy.com/docs/examples/orchestrate-tasks-loop Hand every authored task under one slug to an orchestrator agent that runs each one in its own bounded worker session and proves completion on disk. --- # React to session end URL: https://compozy.com/docs/examples/react-to-session-end Watch for sessions that stop with an error and have an agent summarize each one — an event-driven trigger with no clock and no inbound request. --- # Review-and-fix loop URL: https://compozy.com/docs/examples/review-and-fix-loop Review a named task with an agent, write inspectable findings, and remediate every one of them until a review round comes back clean. --- # Webhook to agent run URL: https://compozy.com/docs/examples/webhook-to-agent-run Turn a signed HTTP request from CI into an agent run — the trigger, the HMAC signature calculated end to end, and the filters that decide when it fires. --- # AGENT.md URL: https://compozy.com/docs/configuration/agent-md Complete implemented AGENT.md schema, parser rules, provider examples, MCP sidecars, and RFC drift. --- # config.toml URL: https://compozy.com/docs/configuration/config-toml Complete CompozyOS config.toml schema, defaults, valid values, merge behavior, and annotated examples. --- # Environment Variables URL: https://compozy.com/docs/configuration/env-vars Environment variables CompozyOS reads, injects, propagates, and explicitly does not support. --- # File Locations URL: https://compozy.com/docs/configuration/file-locations All CompozyOS global, workspace, agent, skill, database, log, socket, memory, and extension paths. --- # Configuration Overview URL: https://compozy.com/docs/configuration Decide which CompozyOS file, overlay, or environment variable should change when you need to configure one machine, one workspace, one agent, or one skill. --- # Config Lifecycle Matrix URL: https://compozy.com/docs/configuration/lifecycle-matrix Generated CompozyOS config lifecycle matrix for live apply, session rebind, and restart-required changes. --- # mcp.json URL: https://compozy.com/docs/configuration/mcp-json Configure, authorize, inspect, edit, and repair local and remote MCP servers across CompozyOS scopes. --- # SKILL.md URL: https://compozy.com/docs/configuration/skill-md Complete implemented SKILL.md schema, CompozyOS metadata, sidecar files, hook declarations, and body conventions. --- # Vault URL: https://compozy.com/docs/configuration/vault Store CompozyOS-managed encrypted secrets with redacted CLI, HTTP, UDS, web, and session-scoped metadata surfaces. --- # Extension Commands URL: https://compozy.com/docs/extensions/commands Present an extension tool as an operator verb — declaration, nested paths, projected flags, and how exec differs from tool invoke. --- # Develop Extensions URL: https://compozy.com/docs/extensions/develop The code-first authoring loop for CompozyOS extensions — init, build, validate, dev, reload, logs, publish — plus provide surfaces, Host API access, and resources. --- # Extensions URL: https://compozy.com/docs/extensions Install or build packages that ship skills, agents, automation, layouts, hooks, MCP servers, provide surfaces, and subprocess tools. --- # Install Extensions URL: https://compozy.com/docs/extensions/install Install extensions from curated, GitHub, git, or local sources; understand trust and consent; update, enable, disable, remove, and inspect provenance. --- # Extension Manifest URL: https://compozy.com/docs/extensions/manifest The single source of truth for extension.toml — generated for subprocess extensions, handwritten for resource-only packages. --- # Extension Permissions URL: https://compozy.com/docs/extensions/permissions Declare the Host API methods an extension calls, read the consent areas CompozyOS derives from them, and understand the ceilings applied per install source. --- # Publish an Extension URL: https://compozy.com/docs/extensions/publish Ship an extension to other people through GitHub Releases or a plain Git repository — no catalog gatekeeper, no pull request to CompozyOS. --- # Extension Secret Bindings URL: https://compozy.com/docs/extensions/secrets Bind declared extension environment names to instance-scoped Vault refs without exposing secret values. --- # compozy URL: https://compozy.com/docs/cli/compozy CompozyOS — the system around your agents, already built --- # compozy doctor URL: https://compozy.com/docs/cli/doctor Run runtime diagnostics --- # compozy drain URL: https://compozy.com/docs/cli/drain Stop admitting new work while in-flight work completes --- # CLI Reference URL: https://compozy.com/docs/cli Generated command reference and cross-cutting behavior for the CompozyOS CLI. --- # compozy install URL: https://compozy.com/docs/cli/install Bootstrap CompozyOS and create the default general agent --- # compozy logs URL: https://compozy.com/docs/cli/logs Read cross-session runtime logs --- # compozy open URL: https://compozy.com/docs/cli/open Open the CompozyOS web UI in the default browser --- # compozy spawn URL: https://compozy.com/docs/cli/spawn Spawn a bounded child agent session --- # compozy status URL: https://compozy.com/docs/cli/status Show consolidated runtime status --- # compozy undrain URL: https://compozy.com/docs/cli/undrain Resume admission of new work --- # compozy uninstall URL: https://compozy.com/docs/cli/uninstall Stop CompozyOS and remove runtime launch artifacts --- # compozy update URL: https://compozy.com/docs/cli/update Check for and apply updates on the active CompozyOS release channel --- # compozy version URL: https://compozy.com/docs/cli/version Print the CompozyOS version --- # compozy whoami URL: https://compozy.com/docs/cli/whoami Print the current CompozyOS agent identity from environment variables --- # Control Bridge Access URL: https://compozy.com/docs/bridges/access Restrict direct messages before enabling a bridge, without confusing webhook authentication, sender authorization, and route isolation. --- # Build an In-Tree Bridge Provider URL: https://compozy.com/docs/bridges/adding-a-bridge Prove the reference adapter, then design, implement, verify, and document a trusted bridge.adapter extension inside the CompozyOS repository. --- # Supported Bridge Behavior URL: https://compozy.com/docs/bridges/behavior Compare the inbound events, route shapes, outbound text operations, progress behavior, and capability limits of every in-tree provider. --- # Bridge Conversations and Sessions URL: https://compozy.com/docs/bridges/conversations Understand how accepted platform events reuse CompozyOS sessions, what happens when a session is busy, and when a new routed session is created. --- # Bridges Overview URL: https://compozy.com/docs/bridges How CompozyOS bridge instances connect workspace agents to external messaging platforms. --- # Bridge Operations URL: https://compozy.com/docs/bridges/operations Inspect, repair, rotate, restart, and validate an existing bridge without losing track of its workspace or provider boundary. --- # Tool progress in bridges URL: https://compozy.com/docs/bridges/progress Configure daemon-rendered tool progress for bridge-delivered agent turns. --- # Bridge Routing URL: https://compozy.com/docs/bridges/routing How bridge routing policies map platform messages to CompozyOS sessions and delivery targets. --- # Discord Setup URL: https://compozy.com/docs/bridges/setup-discord Configure an Ed25519-signed Discord endpoint, install the bot, and choose a truthful server, thread, or DM routing boundary. --- # Google Chat Setup URL: https://compozy.com/docs/bridges/setup-gchat Configure a Google Chat app with direct HTTP, Pub/Sub, or hybrid ingress and verify the CompozyOS bridge end to end. --- # GitHub Setup URL: https://compozy.com/docs/bridges/setup-github Connect one repository's issue and review comments through PAT or GitHub App authentication. --- # Linear Setup URL: https://compozy.com/docs/bridges/setup-linear Connect Linear comments or Agent Sessions with API-key or OAuth client-credentials authentication. --- # Slack Setup URL: https://compozy.com/docs/bridges/setup-slack Create a signed Events API integration, route Slack channels safely, and understand how the /compozy prompt command is delivered. --- # Microsoft Teams Setup URL: https://compozy.com/docs/bridges/setup-teams Provision a Teams bot app, connect its Bot Framework endpoint, and verify a route-specific CompozyOS bridge. --- # Telegram Setup URL: https://compozy.com/docs/bridges/setup-telegram Create a BotFather bot, register an authenticated webhook through the CompozyOS setup wizard, and prove topic-aware delivery. --- # WhatsApp Setup URL: https://compozy.com/docs/bridges/setup-whatsapp Configure Meta's official WhatsApp Cloud API, verify its webhook, and send a real CompozyOS bridge message. --- # Bridge Setup URL: https://compozy.com/docs/bridges/setup Build and install an in-tree provider, follow its operator guide, and prove the inbound and outbound path before production use. --- # Gateway URL: https://compozy.com/docs/gateway Reach your CompozyOS daemon from your other devices, give webhook senders a public delivery address, and take it all back — one explicit switch at a time. --- # Devices, audit, and teardown URL: https://compozy.com/docs/gateway/manage See what is reachable right now, manage and revoke paired devices, audit the exposure posture, and turn the gateway off — one surface or all of it. --- # Gateway quickstart URL: https://compozy.com/docs/gateway/quickstart Reach CompozyOS from your phone or laptop in about ten minutes — enable the gateway, pair a device, and open the web UI from anywhere. --- # Remote CLI, SSH, and public access URL: https://compozy.com/docs/gateway/remote-access Operate a remote daemon from the CLI with a connection profile, reach it over SSH with zero exposure, or put the operator surface on the public internet with explicit consent. --- # Gateway security URL: https://compozy.com/docs/gateway/security What each gateway switch exposes and to whom, who can see your traffic, what CompozyOS guarantees when things fail, and what you still have to do yourself. --- # Tailscale extension URL: https://compozy.com/docs/gateway/tailscale Set up and operate the bundled Tailscale connectivity extension — auth key, tailnet prerequisites, Funnel for public delivery, state, and clean removal. --- # Receive GitHub webhooks URL: https://compozy.com/docs/gateway/webhooks Give GitHub a public delivery URL on your own machine — expose delivery ingress over Tailscale Funnel, sign deliveries from a workflow, and watch a push land as an automation run. --- # Desktop app URL: https://compozy.com/docs/getting-started/desktop-app Start CompozyOS from the desktop, attach to an existing runtime, and understand app-owned updates and recovery. --- # Your first custom agent URL: https://compozy.com/docs/getting-started/first-agent Create one minimal AGENT.md definition, store it in the correct runtime path, and verify that CompozyOS resolves it for the current workspace. --- # Getting Started URL: https://compozy.com/docs/getting-started Install CompozyOS, choose the desktop app or command path, run a real session end to end, and inspect the same runtime state from the browser. --- # Installation URL: https://compozy.com/docs/getting-started/installation Install the CompozyOS desktop app or the compozy command and prepare the local runtime. --- # Quick Start URL: https://compozy.com/docs/getting-started/quick-start Start the CompozyOS daemon, create a real session, attach while it is active, inspect its durable history, and stop it during cleanup. --- # Web UI URL: https://compozy.com/docs/getting-started/web-ui Open the CompozyOS web UI, inspect the session you already created, and compare the browser view with the same daemon state you saw in the CLI. --- # Hook Declaration Format URL: https://compozy.com/docs/hooks/declaration Reference for declaring CompozyOS hooks, matchers, subprocess executors, ordering, and runtime execution behavior. --- # Hook Event Catalog URL: https://compozy.com/docs/hooks/event-catalog Complete reference for CompozyOS hook events, payload schemas, patch schemas, sync eligibility, and example payloads. --- # Hooks URL: https://compozy.com/docs/hooks Intercept named runtime events, inspect the payload, and emit a JSON patch that CompozyOS applies in a deterministic order. --- # Build your first extension URL: https://compozy.com/docs/guides/build-your-first-extension Scaffold, link, and invoke a working CompozyOS extension in three commands, then iterate with edit and reload. --- # Choose a control surface URL: https://compozy.com/docs/guides/choose-an-operator-surface Choose among the CLI, web UI, HTTP/SSE, UDS, native tools, and MCP by actor and trust boundary. --- # Coordinate Agents over Compozy Network URL: https://compozy.com/docs/guides/coordinate-agents-over-network Start with Local, opt one execution into bounded Live participation, address a peer, and inspect conversation and usage evidence. --- # Debug a failed or stuck session URL: https://compozy.com/docs/guides/debug-a-failed-session Diagnose CompozyOS sessions by checking daemon health, session status, event history, repair output, and stored runtime files. --- # Runtime Guides URL: https://compozy.com/docs/guides Goal-oriented guides for running, debugging, and coordinating real CompozyOS work without reading the full reference first. --- # Authoring loop URL: https://compozy.com/docs/loops/authoring The safe path to change a Loop — describe, validate, dry-run, then publish with a compare-and-swap version — with no LLM spend before you run. --- # Catalog and detail URL: https://compozy.com/docs/loops/catalog Browse the Loops installed in a workspace, read a Loop's contract and body, and launch a run. --- # Configure URL: https://compozy.com/docs/loops/configure Adjust how a Loop runs — its checks, its human gate, its re-attempt strategy, and its stop limits — without changing its structure. --- # Example: converse and decide URL: https://compozy.com/docs/loops/converse-and-decide A documented Loop that posts a question into a channel, lets agents converse, harvests the agreed decision, and branches on it. --- # compozy.loop/v1 DSL URL: https://compozy.com/docs/loops/dsl-reference The Loop definition schema — declared inputs, the contract, node classes and kinds, the gate contract, and start bindings. --- # Extending Loops URL: https://compozy.com/docs/loops/extensions How extensions add Loop definitions, actions, gate checks, and watch sources — reusing CompozyOS's existing surfaces, with one new bridge capability. --- # Failure handling URL: https://compozy.com/docs/loops/failure-handling Classify failures, bound retries, route or absorb errors, react with effects, and recover parked or quarantined nodes. --- # Goal node reference URL: https://compozy.com/docs/loops/goal-node The exact compozy.loop/v1 Goal action schema, judge contract, session and retry rules, lint codes, and approval grants. --- # Operate a Goal from a session URL: https://compozy.com/docs/loops/goals Start, inspect, replace, pause, resume, draft, and audit a durable Goal through session commands, native tools, and Run history. --- # Guardrails and outcomes URL: https://compozy.com/docs/loops/guardrails The stop model — no-progress checks, parked work, budgets and ceilings, and the twelve run states a Loop can hold. --- # Loop hooks URL: https://compozy.com/docs/loops/hooks The loop.* hook family — seven events, which two can block a Loop, and the payload every observer receives. --- # Loops URL: https://compozy.com/docs/loops Named, goal-seeking, self-correcting units of work the daemon owns, runs unattended, and always stops cleanly with a named outcome. --- # Ratchets URL: https://compozy.com/docs/loops/ratchet Keep the best scored generation, reject regressions, and restore the accepted baseline before the next targeted repair. --- # Reference grammar URL: https://compozy.com/docs/loops/reference-grammar How Loop definitions reference data — value templates, CEL conditions, effect context, and the snake_case ID rule. --- # Running and observing URL: https://compozy.com/docs/loops/running Fill the run form, dry-run a plan, watch generations stream live, handle approval gates, and track every run across the workspace. --- # Visual editor URL: https://compozy.com/docs/loops/visual-editor Fork a Loop and edit its body on a canvas — nodes, edges, a per-node inspector, an inline linter, and a Graph/DSL toggle over one canonical definition. --- # Marketplace URL: https://compozy.com/docs/marketplace Discover, inspect, install, authorize, update, and manage skills, extensions, and MCP servers through one catalog. --- # Curated MCP catalog URL: https://compozy.com/docs/marketplace/mcp-catalog Reference for the MCP servers CompozyOS curates, their safe defaults, and deliberate omissions. --- # Memory Best Practices URL: https://compozy.com/docs/memory/best-practices Practical rules for writing useful CompozyOS memories, keeping indexes readable, and avoiding context bloat. --- # Dream URL: https://compozy.com/docs/memory/dream How CompozyOS gates dreaming runs, scores recall signals, promotes durable memory through the controller, and persists dreaming artifacts under `_system/`. --- # Memory URL: https://compozy.com/docs/memory How CompozyOS stores durable Markdown memory across global, workspace, and agent scopes, gates dreaming runs, and routes every write through the controller. --- # Memory scopes URL: https://compozy.com/docs/memory/scopes How CompozyOS resolves the three memory scopes — global, workspace, and agent — selects the agent tier, applies read precedence, and shadows entries by identity. --- # Memory System URL: https://compozy.com/docs/memory/system How CompozyOS stores curated Markdown memory, captures a frozen snapshot at session start, and routes every write through the controller WAL. --- # Migrate from v0.2.15 URL: https://compozy.com/docs/migration Complete command, configuration, extension, SDK, and clean-state migration guide for CompozyOS v0.3. --- # Participation, Channels, and Peers URL: https://compozy.com/docs/network/channels-and-peers How CompozyOS resolves Local or Live participation, derives workspace channels, and registers Live sessions as peers. --- # Delivery, Admission, and Usage URL: https://compozy.com/docs/network/delivery-and-safety How CompozyOS commits Network history before in-process notification, admits bounded Live wakes, and settles truthful usage. --- # Direct Rooms URL: https://compozy.com/docs/network/directs Use Compozy Network direct rooms — the restricted two-party conversation container — through the CLI, native tools, HTTP API, and extension Host API. --- # Network Overview URL: https://compozy.com/docs/network How Local and Live participation control Compozy Network state, tools, conversations, wakes, and usage. --- # Protocol Model URL: https://compozy.com/docs/network/protocol-model The core concepts behind compozy-network/v0 and how the CompozyOS runtime binds them to Local/Live execution participation. --- # Task Promotion URL: https://compozy.com/docs/network/task-promotion Promote a Network thread into durable task intent without granting peers task mutation authority. --- # Public Threads URL: https://compozy.com/docs/network/threads Use Compozy Network public threads — the N-to-N conversation container — through the CLI, native tools, HTTP API, and extension Host API. --- # Network Work URL: https://compozy.com/docs/network/work Inspect Compozy Network `work_id` lifecycle through the CLI, native tools, HTTP API, and extension Host API. Work is bound to one conversation container. --- # Daemon Operations URL: https://compozy.com/docs/operations/daemon Start, stop, restart, inspect, and supervise the CompozyOS daemon. --- # Database Operations URL: https://compozy.com/docs/operations/database Back up, inspect, and clean up CompozyOS's SQLite databases. --- # Desktop app operations URL: https://compozy.com/docs/operations/desktop-app Diagnose desktop launch failures, inspect platform logs, and recover app or runtime updates safely. --- # Operations URL: https://compozy.com/docs/operations Day-two operation of the CompozyOS daemon — process supervision, SQLite backup and inspection, troubleshooting, and production readiness. --- # Expose CompozyOS over MCP URL: https://compozy.com/docs/operations/mcp-serve Connect a trusted MCP client to the workspace-bound CompozyOS Host API over stdio or authenticated loopback HTTP. --- # Production checklist URL: https://compozy.com/docs/operations/production Prepare CompozyOS for persistent unattended operation with clear pass and fail checks. --- # Support Bundles URL: https://compozy.com/docs/operations/support-bundles Create redacted, daemon-owned support bundles for incident response and maintainer triage. --- # Troubleshooting URL: https://compozy.com/docs/operations/troubleshooting Diagnose and resolve common CompozyOS daemon, socket, agent, session, and database issues. --- # Desired-State Resources URL: https://compozy.com/docs/resources How CompozyOS stores extensible runtime resources, validates mutations, and reconciles projected runtime state. --- # Daytona Sandbox Provider URL: https://compozy.com/docs/sandbox/daytona Configure and operate the implemented Daytona sandbox backend. --- # Sandbox URL: https://compozy.com/docs/sandbox How CompozyOS runs sessions on the host or inside provider-backed sandboxes. --- # Sandbox Profiles URL: https://compozy.com/docs/sandbox/profiles Configure sandbox profiles, defaults, workspace selection, and safe-spawn grants. --- # Bundled Skill URL: https://compozy.com/docs/skills/bundled The CompozyOS skill compiled into the runtime, its reference files, and how contextual loading works. --- # Skills Overview URL: https://compozy.com/docs/skills How CompozyOS discovers skills, resolves precedence, injects the prompt catalog, and connects skills to MCP servers. --- # Skills Marketplace URL: https://compozy.com/docs/skills/marketplace How to discover, install, update, and remove marketplace skills with CompozyOS. --- # SKILL.md Format URL: https://compozy.com/docs/skills/skill-md The accepted SKILL.md frontmatter schema, Markdown body rules, MCP sidecars, hooks, and complete examples. --- # Event Streaming URL: https://compozy.com/docs/sessions/events How CompozyOS records session events, streams them over SSE, and persists them in per-session SQLite databases. --- # Session Health URL: https://compozy.com/docs/sessions/health Metadata-only session presence, attachability, wake eligibility, and boundaries with HEARTBEAT.md policy, task leases, and network greet presence. --- # Sessions URL: https://compozy.com/docs/sessions The durable runtime unit CompozyOS creates, attaches, audits, and governs. --- # Session lifecycle URL: https://compozy.com/docs/sessions/lifecycle How CompozyOS creates, activates, stops, and classifies one durable runtime session. --- # Permissions URL: https://compozy.com/docs/sessions/permissions How CompozyOS applies static permission modes, workspace boundaries, and interactive approvals during session execution. --- # Resume Attach and Replay URL: https://compozy.com/docs/sessions/resume How CompozyOS attaches operators to resumable sessions, reconstructs transcripts from events, and returns deterministic recaps. --- # Tool Registry URL: https://compozy.com/docs/tools How CompozyOS exposes daemon-owned tools to operators and managed agents through one policy-checked registry. --- # Policy and Invocation URL: https://compozy.com/docs/tools/policy-and-invocation How CompozyOS validates tool input, applies daemon policy, handles approvals, redacts sensitive fields, and records invocation evidence. --- # Oversized Tool Results URL: https://compozy.com/docs/tools/result-artifacts Open, page, and retain exact tool results that exceed the active result budget. --- # Toolsets URL: https://compozy.com/docs/tools/toolsets How CompozyOS groups registry tools into named exposure sets for discovery, policy, and session startup. --- # Handoff between agents URL: https://compozy.com/docs/use-cases/handoff-between-agents Use a Compozy Network thread to request work, return evidence, and close the network work lifecycle. --- # Use Cases URL: https://compozy.com/docs/use-cases Outcome-oriented CompozyOS operating paths for code review, release readiness, and agent handoff. --- # Prepare a project workspace URL: https://compozy.com/docs/use-cases/prepare-a-project-workspace Turn an existing repository into a CompozyOS workspace that agents can inspect, remember, and operate through durable sessions. --- # Release Readiness Sweep URL: https://compozy.com/docs/use-cases/release-readiness-sweep Use CompozyOS tasks and sessions to run release checks with durable ownership and completion evidence. --- # Review a Change URL: https://compozy.com/docs/use-cases/review-a-change Use a CompozyOS session to inspect a code change and return durable review evidence. --- # Workspace Config Overlays URL: https://compozy.com/docs/workspaces/config-overlays How workspace config.toml and mcp.json layer over global CompozyOS configuration without making project copies brittle. --- # Workspaces URL: https://compozy.com/docs/workspaces How CompozyOS resolves workspace roots, layers config overlays, and attaches additional roots for monorepos and cross-project agent sharing. --- # Multi-Root Workspaces URL: https://compozy.com/docs/workspaces/multi-root How to attach additional directories to one CompozyOS workspace for monorepos, shared agents, and project clusters. --- # Workspace Resolver URL: https://compozy.com/docs/workspaces/resolver How CompozyOS registers workspace roots, resolves the active workspace, and discovers project-local runtime resources. --- # Window Management URL: https://compozy.com/docs/workspaces/window-management Persistent virtual desktops, semantic window placement, revision-safe layouts, connected clients, and recovery. --- # Agent Management Surface URL: https://compozy.com/docs/worktrees/agent-surface Operate Worktrees through structured CLI, HTTP, UDS, native tools, events, hooks, and stable error codes. --- # Assisted Exit URL: https://compozy.com/docs/worktrees/assisted-exit Follow the daemon-computed ladder to commit, push, open a pull request, and confirm cleanup evidence. --- # Worktree Configuration URL: https://compozy.com/docs/worktrees/configuration Configure managed placement, per-run branch names, bootstrap copying, setup, discovery freshness, and the default Task policy. --- # Create or Adopt a Worktree URL: https://compozy.com/docs/worktrees/create-and-adopt Create a managed linked checkout, follow its setup phases, or adopt an existing Git worktree. --- # Worktrees URL: https://compozy.com/docs/worktrees Run sessions, tasks, and Loops in isolated Git checkouts while sharing the parent workspace's runtime context. --- # Loop Environments URL: https://compozy.com/docs/worktrees/loop-environments Run Loop agent actions at the workspace root, in one Worktree, in a fresh Worktree per execution, or in a contained directory. --- # Navigation and Selection URL: https://compozy.com/docs/worktrees/navigation Select a Worktree in Web or bind a new session to one without changing the parent workspace. --- # Removal and Recovery URL: https://compozy.com/docs/worktrees/removal-and-recovery Remove a linked checkout after safety checks or recover a Worktree that disappeared outside CompozyOS. --- # Task Isolation URL: https://compozy.com/docs/worktrees/task-isolation Bind task runs to one Worktree or create a fresh checkout for every run and fan-out designation. --- # compozy agent create URL: https://compozy.com/docs/cli/agent/create Create a global or workspace-local agent definition --- # compozy agent delete URL: https://compozy.com/docs/cli/agent/delete Durably delete an agent definition --- # compozy agent duplicate URL: https://compozy.com/docs/cli/agent/duplicate Duplicate an agent definition without exposing secrets --- # compozy agent URL: https://compozy.com/docs/cli/agent Inspect CompozyOS agent definitions --- # compozy agent info URL: https://compozy.com/docs/cli/agent/info Show one agent definition --- # compozy agent list URL: https://compozy.com/docs/cli/agent/list List installed agent definitions --- # compozy agent update URL: https://compozy.com/docs/cli/agent/update Update an agent definition for future sessions --- # compozy app diagnose URL: https://compozy.com/docs/cli/app/diagnose Show safe desktop diagnostics --- # compozy app URL: https://compozy.com/docs/cli/app Manage the CompozyOS desktop app --- # compozy app open URL: https://compozy.com/docs/cli/app/open Launch or focus the desktop app --- # compozy app retry URL: https://compozy.com/docs/cli/app/retry Retry the current desktop app operation --- # compozy app status URL: https://compozy.com/docs/cli/app/status Show desktop app status --- # compozy app update URL: https://compozy.com/docs/cli/app/update Check or apply desktop-managed updates --- # compozy automation URL: https://compozy.com/docs/cli/automation Manage automation jobs, triggers, suggestions, and runs --- # compozy bridge create URL: https://compozy.com/docs/cli/bridge/create Create a bridge instance --- # compozy bridge disable URL: https://compozy.com/docs/cli/bridge/disable Disable a bridge instance --- # compozy bridge enable URL: https://compozy.com/docs/cli/bridge/enable Enable a bridge instance --- # compozy bridge get URL: https://compozy.com/docs/cli/bridge/get Show one bridge instance --- # compozy bridge URL: https://compozy.com/docs/cli/bridge Manage bridge instances --- # compozy bridge list URL: https://compozy.com/docs/cli/bridge/list List bridge instances --- # compozy bridge resolve URL: https://compozy.com/docs/cli/bridge/resolve Resolve a bridge target name without sending --- # compozy bridge restart URL: https://compozy.com/docs/cli/bridge/restart Restart a bridge instance --- # compozy bridge routes URL: https://compozy.com/docs/cli/bridge/routes Inspect routes for one bridge instance --- # compozy bridge send-test URL: https://compozy.com/docs/cli/bridge/send-test Send one real message through a bridge provider --- # compozy bridge targets URL: https://compozy.com/docs/cli/bridge/targets List discovered targets for one bridge instance --- # compozy bridge test-delivery URL: https://compozy.com/docs/cli/bridge/test-delivery Resolve a typed outbound delivery target for one bridge instance --- # compozy bridge update URL: https://compozy.com/docs/cli/bridge/update Update mutable bridge fields --- # compozy bridge verify URL: https://compozy.com/docs/cli/bridge/verify Run live provider checks for one bridge instance --- # compozy ch URL: https://compozy.com/docs/cli/ch Use agent-facing coordination channels --- # compozy ch list URL: https://compozy.com/docs/cli/ch/list List coordination channels visible to the current agent session --- # compozy ch recv URL: https://compozy.com/docs/cli/ch/recv Receive queued coordination messages for a channel --- # compozy ch reply URL: https://compozy.com/docs/cli/ch/reply Reply to a received coordination message --- # compozy ch send URL: https://compozy.com/docs/cli/ch/send Send one task-run coordination message --- # compozy config apply-history URL: https://compozy.com/docs/cli/config/apply-history List persisted config apply records --- # compozy config check URL: https://compozy.com/docs/cli/config/check Alias for config validate --- # compozy config edit URL: https://compozy.com/docs/cli/config/edit Open the selected config overlay in $VISUAL or $EDITOR --- # compozy config get URL: https://compozy.com/docs/cli/config/get Get one redacted effective config value --- # compozy config URL: https://compozy.com/docs/cli/config Inspect and mutate CompozyOS configuration --- # compozy config list URL: https://compozy.com/docs/cli/config/list List redacted effective config values --- # compozy config path URL: https://compozy.com/docs/cli/config/path Show resolved CompozyOS config paths --- # compozy config reload URL: https://compozy.com/docs/cli/config/reload Reconcile config.toml with the daemon active generation --- # compozy config set URL: https://compozy.com/docs/cli/config/set Set one config value through the validated config writer --- # compozy config show URL: https://compozy.com/docs/cli/config/show Show the redacted effective config --- # compozy config unset URL: https://compozy.com/docs/cli/config/unset Remove one config value through the validated config writer --- # compozy config validate URL: https://compozy.com/docs/cli/config/validate Validate CompozyOS configuration --- # compozy connect add URL: https://compozy.com/docs/cli/connect/add Add a paired HTTPS connection profile --- # compozy connect export URL: https://compozy.com/docs/cli/connect/export Export a portable encrypted HTTPS profile --- # compozy connect import URL: https://compozy.com/docs/cli/connect/import Import a portable encrypted HTTPS profile --- # compozy connect URL: https://compozy.com/docs/cli/connect Manage CLI connection profiles --- # compozy connect list URL: https://compozy.com/docs/cli/connect/list List connection profiles without reading credentials --- # compozy connect remove URL: https://compozy.com/docs/cli/connect/remove Remove profile metadata and its client-local credential --- # compozy connect ssh URL: https://compozy.com/docs/cli/connect/ssh Reach a remote daemon through a loopback-only SSH forward --- # compozy connect use URL: https://compozy.com/docs/cli/connect/use Choose the default CLI target --- # compozy completion bash URL: https://compozy.com/docs/cli/completion/bash Generate the autocompletion script for bash --- # compozy completion fish URL: https://compozy.com/docs/cli/completion/fish Generate the autocompletion script for fish --- # compozy completion URL: https://compozy.com/docs/cli/completion Generate the autocompletion script for the specified shell --- # compozy completion powershell URL: https://compozy.com/docs/cli/completion/powershell Generate the autocompletion script for powershell --- # compozy completion zsh URL: https://compozy.com/docs/cli/completion/zsh Generate the autocompletion script for zsh --- # compozy daemon URL: https://compozy.com/docs/cli/daemon Manage the CompozyOS daemon --- # compozy daemon start URL: https://compozy.com/docs/cli/daemon/start Start the CompozyOS daemon --- # compozy daemon stop URL: https://compozy.com/docs/cli/daemon/stop Stop the CompozyOS daemon --- # compozy device URL: https://compozy.com/docs/cli/device Manage paired gateway devices --- # compozy device list URL: https://compozy.com/docs/cli/device/list List paired devices --- # compozy device rename URL: https://compozy.com/docs/cli/device/rename Rename a paired device --- # compozy device revoke URL: https://compozy.com/docs/cli/device/revoke Revoke a paired device and close its live streams --- # compozy desktop create URL: https://compozy.com/docs/cli/desktop/create Create a persistent virtual desktop --- # compozy desktop delete URL: https://compozy.com/docs/cli/desktop/delete Delete a desktop with an explicit transfer destination when needed --- # compozy desktop URL: https://compozy.com/docs/cli/desktop Manage virtual desktops in a workspace --- # compozy desktop list URL: https://compozy.com/docs/cli/desktop/list List persistent virtual desktops --- # compozy desktop reorder URL: https://compozy.com/docs/cli/desktop/reorder Move a desktop to an ordered position --- # compozy desktop switch URL: https://compozy.com/docs/cli/desktop/switch Switch one connected client to a desktop --- # compozy desktop update URL: https://compozy.com/docs/cli/desktop/update Rename a virtual desktop --- # compozy gateway audit URL: https://compozy.com/docs/cli/gateway/audit Audit gateway security posture --- # compozy gateway URL: https://compozy.com/docs/cli/gateway Manage remote gateway exposure --- # compozy gateway status URL: https://compozy.com/docs/cli/gateway/status Show gateway exposure and device state --- # compozy hooks events URL: https://compozy.com/docs/cli/hooks/events List supported hook events --- # compozy hooks URL: https://compozy.com/docs/cli/hooks Inspect configured and executed hooks --- # compozy hooks info URL: https://compozy.com/docs/cli/hooks/info Show detailed information for one or more hooks by name --- # compozy hooks list URL: https://compozy.com/docs/cli/hooks/list List resolved hooks in pipeline order --- # compozy hooks runs URL: https://compozy.com/docs/cli/hooks/runs Show persisted hook execution history --- # compozy extension build URL: https://compozy.com/docs/cli/extension/build Build source into an immutable extension bundle --- # compozy extension commands URL: https://compozy.com/docs/cli/extension/commands List active extension-contributed commands --- # compozy extension dev URL: https://compozy.com/docs/cli/extension/dev Build and link an extension to the current workspace --- # compozy extension disable URL: https://compozy.com/docs/cli/extension/disable Disable an installed extension --- # compozy extension enable URL: https://compozy.com/docs/cli/extension/enable Enable an installed extension --- # compozy extension exec URL: https://compozy.com/docs/cli/extension/exec Invoke an extension command through daemon tool policy --- # compozy extension URL: https://compozy.com/docs/cli/extension Manage CompozyOS extensions --- # compozy extension init URL: https://compozy.com/docs/cli/extension/init Create an extension project from an embedded template --- # compozy extension install URL: https://compozy.com/docs/cli/extension/install Install an extension from curated, GitHub, git, or a local path --- # compozy extension inventory URL: https://compozy.com/docs/cli/extension/inventory Show shipped and live resources for an extension --- # compozy extension list URL: https://compozy.com/docs/cli/extension/list List installed extensions --- # compozy extension logs URL: https://compozy.com/docs/cli/extension/logs Read redacted logs for one extension instance --- # compozy extension preview URL: https://compozy.com/docs/cli/extension/preview Preview enabling an extension without changing state --- # compozy extension provenance URL: https://compozy.com/docs/cli/extension/provenance Show extension provenance and trust report --- # compozy extension publish URL: https://compozy.com/docs/cli/extension/publish Publish an immutable extension generation to GitHub Releases --- # compozy extension reload URL: https://compozy.com/docs/cli/extension/reload Build and atomically reload a dev-linked extension --- # compozy extension remove URL: https://compozy.com/docs/cli/extension/remove Remove an installed extension from disk and the registry --- # compozy extension search URL: https://compozy.com/docs/cli/extension/search Search curated and GitHub extensions --- # compozy extension status URL: https://compozy.com/docs/cli/extension/status Show extension runtime status --- # compozy extension update URL: https://compozy.com/docs/cli/extension/update Check for or install extension updates --- # compozy extension validate URL: https://compozy.com/docs/cli/extension/validate Validate an extension bundle without running its code --- # compozy layout-profile delete URL: https://compozy.com/docs/cli/layout-profile/delete Delete one saved layout --- # compozy layout-profile get URL: https://compozy.com/docs/cli/layout-profile/get Get one saved layout --- # compozy layout-profile URL: https://compozy.com/docs/cli/layout-profile List, read, save, and delete saved layouts --- # compozy layout-profile list URL: https://compozy.com/docs/cli/layout-profile/list List saved layouts visible to a workspace, global scope included --- # compozy layout-profile put URL: https://compozy.com/docs/cli/layout-profile/put Create or replace one saved layout --- # compozy layout apply URL: https://compozy.com/docs/cli/layout/apply Atomically replace topology from a validated layout document --- # compozy layout arrange URL: https://compozy.com/docs/cli/layout/arrange Arrange explicit windows or apply a declarative layout resource --- # compozy layout balance URL: https://compozy.com/docs/cli/layout/balance Equalize one split or every split in a group --- # compozy layout export URL: https://compozy.com/docs/cli/layout/export Export a history-free declarative layout document --- # compozy layout frame-resize URL: https://compozy.com/docs/cli/layout/frame-resize Atomically rewrite island frames to move a shared tiled boundary --- # compozy layout get URL: https://compozy.com/docs/cli/layout/get Get the authoritative topology and revision --- # compozy layout URL: https://compozy.com/docs/cli/layout Inspect, preview, and change workspace layouts --- # compozy layout preview URL: https://compozy.com/docs/cli/layout/preview Preview any semantic window-manager command without writing --- # compozy layout redo URL: https://compozy.com/docs/cli/layout/redo Redo the latest undone layout operation --- # compozy layout resize URL: https://compozy.com/docs/cli/layout/resize Resize one shared split boundary --- # compozy layout undo URL: https://compozy.com/docs/cli/layout/undo Undo the latest workspace layout operation --- # compozy layout validate URL: https://compozy.com/docs/cli/layout/validate Validate a declarative layout without writing it --- # compozy layout watch URL: https://compozy.com/docs/cli/layout/watch Watch topology events and optional client presentation frames --- # compozy marketplace URL: https://compozy.com/docs/cli/marketplace Discover installable CompozyOS capabilities --- # compozy marketplace info URL: https://compozy.com/docs/cli/marketplace/info Show one marketplace entry --- # compozy marketplace refresh URL: https://compozy.com/docs/cli/marketplace/refresh Refresh curated marketplace catalogs --- # compozy marketplace search URL: https://compozy.com/docs/cli/marketplace/search Search or browse the marketplace --- # compozy loop approve URL: https://compozy.com/docs/cli/loop/approve Apply one Loop human-gate decision --- # compozy loop cancel URL: https://compozy.com/docs/cli/loop/cancel Cancel one Loop run --- # compozy loop configure URL: https://compozy.com/docs/cli/loop/configure Write per-loop runtime config overrides --- # compozy loop create URL: https://compozy.com/docs/cli/loop/create Create, fork, or publish one Loop definition --- # compozy loop delete URL: https://compozy.com/docs/cli/loop/delete Delete one user-authored Loop definition --- # compozy loop edit URL: https://compozy.com/docs/cli/loop/edit Edit and publish one Loop definition with $EDITOR --- # compozy loop URL: https://compozy.com/docs/cli/loop Manage Loop definitions and runs --- # compozy loop inspect URL: https://compozy.com/docs/cli/loop/inspect Inspect one Loop definition --- # compozy loop kill URL: https://compozy.com/docs/cli/loop/kill Kill one Loop run --- # compozy loop list URL: https://compozy.com/docs/cli/loop/list List Loop definitions --- # compozy loop nodes URL: https://compozy.com/docs/cli/loop/nodes List workspace Loop node state --- # compozy loop pause URL: https://compozy.com/docs/cli/loop/pause Pause one Loop run --- # compozy loop resume URL: https://compozy.com/docs/cli/loop/resume Resume one Loop run --- # compozy loop run URL: https://compozy.com/docs/cli/loop/run Start or dry-run one Loop --- # compozy loop runs URL: https://compozy.com/docs/cli/loop/runs List workspace Loop runs --- # compozy loop status URL: https://compozy.com/docs/cli/loop/status Inspect one Loop run --- # compozy loop turns URL: https://compozy.com/docs/cli/loop/turns List one Loop run's Goal turn audit --- # compozy loop validate URL: https://compozy.com/docs/cli/loop/validate Validate one Loop definition without saving --- # compozy mcp URL: https://compozy.com/docs/cli/mcp Manage MCP integrations --- # compozy mcp install URL: https://compozy.com/docs/cli/mcp/install Install a curated MCP server --- # compozy mcp serve URL: https://compozy.com/docs/cli/mcp/serve Serve the workspace-bound CompozyOS Host API over MCP --- # compozy me context URL: https://compozy.com/docs/cli/me/context Inspect the bounded situation context for the current agent session --- # compozy me URL: https://compozy.com/docs/cli/me Inspect the current CompozyOS-managed agent session --- # compozy network inbox URL: https://compozy.com/docs/cli/network/inbox Show queued inbound messages for one session --- # compozy network URL: https://compozy.com/docs/cli/network Operate the daemon-owned network runtime --- # compozy network mute URL: https://compozy.com/docs/cli/network/mute Mute one peer's network delivery --- # compozy network peers URL: https://compozy.com/docs/cli/network/peers List visible local peers and their capability cards --- # compozy network send URL: https://compozy.com/docs/cli/network/send Send one envelope through the daemon-owned network runtime --- # compozy network status URL: https://compozy.com/docs/cli/network/status Show Network availability, Live participation, and runtime metrics --- # compozy network subscribe URL: https://compozy.com/docs/cli/network/subscribe Subscribe one peer to full delivery --- # compozy network unmute URL: https://compozy.com/docs/cli/network/unmute Remove one network delivery preference --- # compozy network usage URL: https://compozy.com/docs/cli/network/usage Show workspace-scoped network wake usage from the ledger --- # compozy memory delete URL: https://compozy.com/docs/cli/memory/delete Delete a Memory v2 entry through the controller --- # compozy memory edit URL: https://compozy.com/docs/cli/memory/edit Edit a Memory v2 entry through the controller --- # compozy memory health URL: https://compozy.com/docs/cli/memory/health Show Memory v2 health --- # compozy memory history URL: https://compozy.com/docs/cli/memory/history Show redaction-safe Memory v2 operation history --- # compozy memory URL: https://compozy.com/docs/cli/memory Show, write, search, and operate Memory v2 durable context --- # compozy memory list URL: https://compozy.com/docs/cli/memory/list List Memory v2 entries --- # compozy memory promote URL: https://compozy.com/docs/cli/memory/promote Promote a memory entry across Memory v2 scopes --- # compozy memory reindex URL: https://compozy.com/docs/cli/memory/reindex Rebuild the derived Memory v2 search catalog --- # compozy memory reload URL: https://compozy.com/docs/cli/memory/reload Invalidate frozen memory snapshots for future session boots --- # compozy memory reset URL: https://compozy.com/docs/cli/memory/reset Reset derived Memory v2 state through the daemon --- # compozy memory scope-show URL: https://compozy.com/docs/cli/memory/scope-show Show resolved Memory v2 precedence for a selector --- # compozy memory search URL: https://compozy.com/docs/cli/memory/search Search deterministic Memory v2 recall --- # compozy memory show URL: https://compozy.com/docs/cli/memory/show Show one Memory v2 entry --- # compozy memory write URL: https://compozy.com/docs/cli/memory/write Create a Memory v2 entry through the controller --- # compozy notifications URL: https://compozy.com/docs/cli/notifications Manage notification presets --- # compozy observe URL: https://compozy.com/docs/cli/observe Inspect runtime observability read models --- # compozy observe overview URL: https://compozy.com/docs/cli/observe/overview Show the home overview: what agents did, what needs you, what it costs --- # compozy onboarding complete URL: https://compozy.com/docs/cli/onboarding/complete Mark first-run onboarding as completed --- # compozy onboarding URL: https://compozy.com/docs/cli/onboarding Inspect and manage first-run onboarding state --- # compozy onboarding reset URL: https://compozy.com/docs/cli/onboarding/reset Clear the onboarding completion flag so the wizard runs again --- # compozy onboarding status URL: https://compozy.com/docs/cli/onboarding/status Show whether first-run onboarding has been completed --- # compozy pair URL: https://compozy.com/docs/cli/pair Pair remote clients with a gateway --- # compozy pair mint URL: https://compozy.com/docs/cli/pair/mint Mint a short-lived pairing artifact into a private handoff file --- # compozy pair redeem URL: https://compozy.com/docs/cli/pair/redeem Redeem a pairing artifact into a named remote profile --- # compozy provider URL: https://compozy.com/docs/cli/provider Inspect and manage provider authentication --- # compozy provider list URL: https://compozy.com/docs/cli/provider/list List providers and declared auth state --- # compozy resource delete URL: https://compozy.com/docs/cli/resource/delete Delete one desired-state resource --- # compozy resource get URL: https://compozy.com/docs/cli/resource/get Show one desired-state resource --- # compozy resource URL: https://compozy.com/docs/cli/resource Manage desired-state resources --- # compozy resource list URL: https://compozy.com/docs/cli/resource/list List desired-state resources --- # compozy resource put URL: https://compozy.com/docs/cli/resource/put Create or update one desired-state resource --- # compozy roles URL: https://compozy.com/docs/cli/roles Inspect effective background role configuration --- # compozy roles list URL: https://compozy.com/docs/cli/roles/list List effective background roles --- # compozy roles show URL: https://compozy.com/docs/cli/roles/show Show one effective background role --- # compozy scheduler backlog URL: https://compozy.com/docs/cli/scheduler/backlog List queued runs visible to scheduler dispatch --- # compozy scheduler drain URL: https://compozy.com/docs/cli/scheduler/drain Pause dispatch and wait for active task claims to finish --- # compozy scheduler URL: https://compozy.com/docs/cli/scheduler Inspect and control task scheduler dispatch --- # compozy scheduler pause URL: https://compozy.com/docs/cli/scheduler/pause Pause new scheduler dispatch --- # compozy scheduler resume URL: https://compozy.com/docs/cli/scheduler/resume Resume scheduler dispatch --- # compozy scheduler status URL: https://compozy.com/docs/cli/scheduler/status Show scheduler pause and queue pressure --- # compozy skill create URL: https://compozy.com/docs/cli/skill/create Scaffold a new workspace skill --- # compozy skill disable URL: https://compozy.com/docs/cli/skill/disable Disable a daemon-managed skill --- # compozy skill enable URL: https://compozy.com/docs/cli/skill/enable Enable a daemon-managed skill --- # compozy skill URL: https://compozy.com/docs/cli/skill Manage local AgentSkills --- # compozy skill info URL: https://compozy.com/docs/cli/skill/info Show one Marketplace skill entry --- # compozy skill inspect URL: https://compozy.com/docs/cli/skill/inspect Inspect installed skill metadata and resources --- # compozy skill install URL: https://compozy.com/docs/cli/skill/install Install a marketplace skill --- # compozy skill list URL: https://compozy.com/docs/cli/skill/list List locally available skills --- # compozy skill remove URL: https://compozy.com/docs/cli/skill/remove Remove an installed marketplace skill --- # compozy skill search URL: https://compozy.com/docs/cli/skill/search Search marketplace skills --- # compozy skill update URL: https://compozy.com/docs/cli/skill/update Check for or install updates for marketplace skills --- # compozy skill view URL: https://compozy.com/docs/cli/skill/view Read a skill or one of its resource files --- # compozy skill where URL: https://compozy.com/docs/cli/skill/where Show every path participating in skill resolution --- # compozy session approve URL: https://compozy.com/docs/cli/session/approve Approve or reject a pending session permission request --- # compozy session archive URL: https://compozy.com/docs/cli/session/archive Archive a stopped session --- # compozy session commands URL: https://compozy.com/docs/cli/session/commands List commands available to a session --- # compozy session events URL: https://compozy.com/docs/cli/session/events Read session events --- # compozy session health URL: https://compozy.com/docs/cli/session/health Read session health and wake eligibility --- # compozy session history URL: https://compozy.com/docs/cli/session/history Show session history grouped by turn --- # compozy session URL: https://compozy.com/docs/cli/session Manage CompozyOS sessions --- # compozy session inspect URL: https://compozy.com/docs/cli/session/inspect Inspect session health, wake audit, and policy correlation --- # compozy session list URL: https://compozy.com/docs/cli/session/list List sessions --- # compozy session new URL: https://compozy.com/docs/cli/session/new Create a new session --- # compozy session prompt URL: https://compozy.com/docs/cli/session/prompt Send a prompt to a session --- # compozy session recap URL: https://compozy.com/docs/cli/session/recap Show deterministic session recap --- # compozy session remove URL: https://compozy.com/docs/cli/session/remove Remove a session and its persisted history --- # compozy session rename URL: https://compozy.com/docs/cli/session/rename Rename a user session --- # compozy session repair URL: https://compozy.com/docs/cli/session/repair Inspect and repair an interrupted session transcript --- # compozy session resume URL: https://compozy.com/docs/cli/session/resume Attach to a resumable session --- # compozy session rewind URL: https://compozy.com/docs/cli/session/rewind Rewind a session before a user message --- # compozy session status URL: https://compozy.com/docs/cli/session/status Show session status --- # compozy session stop URL: https://compozy.com/docs/cli/session/stop Stop a session --- # compozy session unarchive URL: https://compozy.com/docs/cli/session/unarchive Restore an archived session --- # compozy session usage URL: https://compozy.com/docs/cli/session/usage Show aggregated session token usage and cost provenance --- # compozy session wait URL: https://compozy.com/docs/cli/session/wait Block until a session stops --- # compozy support bundle URL: https://compozy.com/docs/cli/support/bundle Create and download a redacted support bundle --- # compozy support URL: https://compozy.com/docs/cli/support Create daemon-owned support artifacts --- # compozy tool approve URL: https://compozy.com/docs/cli/tool/approve Mint a one-shot approval token for one tool invocation --- # compozy tool URL: https://compozy.com/docs/cli/tool Inspect and invoke registry tools --- # compozy tool info URL: https://compozy.com/docs/cli/tool/info Show one registry tool descriptor and diagnostics --- # compozy tool invoke URL: https://compozy.com/docs/cli/tool/invoke Invoke one registry tool through daemon policy --- # compozy tool list URL: https://compozy.com/docs/cli/tool/list List operator-visible registry tools --- # compozy tool search URL: https://compozy.com/docs/cli/tool/search Search operator-visible registry tools --- # compozy task approve URL: https://compozy.com/docs/cli/task/approve Approve a task and enqueue its first run --- # compozy task block URL: https://compozy.com/docs/cli/task/block Block a task with a typed reason --- # compozy task blocks URL: https://compozy.com/docs/cli/task/blocks List task blocks --- # compozy task cancel URL: https://compozy.com/docs/cli/task/cancel Cancel a task tree --- # compozy task complete URL: https://compozy.com/docs/cli/task/complete Complete a claimed task run for the current agent session --- # compozy task create URL: https://compozy.com/docs/cli/task/create Create a task --- # compozy task delete URL: https://compozy.com/docs/cli/task/delete Delete a task --- # compozy task fail URL: https://compozy.com/docs/cli/task/fail Fail task runs through a session-bound lease or operator override --- # compozy task fan-out URL: https://compozy.com/docs/cli/task/fan-out Enqueue designated sibling runs for one task --- # compozy task get URL: https://compozy.com/docs/cli/task/get Show one task with related detail --- # compozy task heartbeat URL: https://compozy.com/docs/cli/task/heartbeat Extend a claimed task run lease for the current agent session --- # compozy task URL: https://compozy.com/docs/cli/task Manage tasks and task runs --- # compozy task inspect URL: https://compozy.com/docs/cli/task/inspect Inspect a task or run with diagnostics --- # compozy task list URL: https://compozy.com/docs/cli/task/list List tasks --- # compozy task next URL: https://compozy.com/docs/cli/task/next Claim the next task run for the current agent session --- # compozy task pause URL: https://compozy.com/docs/cli/task/pause Pause new runs for one task --- # compozy task promote URL: https://compozy.com/docs/cli/task/promote Promote one network thread message into a task --- # compozy task publish URL: https://compozy.com/docs/cli/task/publish Publish a draft task and enqueue its first run --- # compozy task recover URL: https://compozy.com/docs/cli/task/recover Recover a task from needs_attention --- # compozy task reject URL: https://compozy.com/docs/cli/task/reject Reject a pending approval task --- # compozy task release URL: https://compozy.com/docs/cli/task/release Force release claimed task runs back to the queue --- # compozy task resume URL: https://compozy.com/docs/cli/task/resume Resume new runs for one paused task --- # compozy task retry URL: https://compozy.com/docs/cli/task/retry Retry one failed task run --- # compozy task start URL: https://compozy.com/docs/cli/task/start Enqueue a run for an executable task --- # compozy task unblock URL: https://compozy.com/docs/cli/task/unblock Clear one task block --- # compozy task update URL: https://compozy.com/docs/cli/task/update Update mutable task fields --- # compozy toolsets URL: https://compozy.com/docs/cli/toolsets Inspect registry toolsets --- # compozy toolsets info URL: https://compozy.com/docs/cli/toolsets/info Show one registry toolset expansion --- # compozy toolsets list URL: https://compozy.com/docs/cli/toolsets/list List registry toolsets --- # compozy vault delete URL: https://compozy.com/docs/cli/vault/delete Delete one vault secret --- # compozy vault get URL: https://compozy.com/docs/cli/vault/get Show redacted metadata for one vault secret --- # compozy vault URL: https://compozy.com/docs/cli/vault Manage encrypted daemon vault metadata and write-only secrets --- # compozy vault list URL: https://compozy.com/docs/cli/vault/list List redacted vault secret metadata --- # compozy vault put URL: https://compozy.com/docs/cli/vault/put Store one write-only vault secret from stdin --- # compozy window activate URL: https://compozy.com/docs/cli/window/activate Activate one member of a window stack --- # compozy window close URL: https://compozy.com/docs/cli/window/close Close or minimize a window and reflow its group --- # compozy window float URL: https://compozy.com/docs/cli/window/float Toggle a window between floating and tiled placement --- # compozy window focus URL: https://compozy.com/docs/cli/window/focus Focus a window by ID or direction for one connected client --- # compozy window group URL: https://compozy.com/docs/cli/window/group Group windows into one ordered stack --- # compozy window URL: https://compozy.com/docs/cli/window Manage windows in virtual desktops --- # compozy window list URL: https://compozy.com/docs/cli/window/list List windows across workspace desktops --- # compozy window move URL: https://compozy.com/docs/cli/window/move Move a window or tiled group to an explicit destination --- # compozy window navigate URL: https://compozy.com/docs/cli/window/navigate Persist a window's internal application route --- # compozy window open URL: https://compozy.com/docs/cli/window/open Open a window or restore a minimized window --- # compozy window pin URL: https://compozy.com/docs/cli/window/pin Pin one managed window --- # compozy window reopen URL: https://compozy.com/docs/cli/window/reopen Restore the newest closed window entry --- # compozy window resize URL: https://compozy.com/docs/cli/window/resize Resize a window frame; a tiled split member detaches into its own island --- # compozy window swap URL: https://compozy.com/docs/cli/window/swap Swap two window placements --- # compozy window unpin URL: https://compozy.com/docs/cli/window/unpin Unpin one managed window --- # compozy window zoom URL: https://compozy.com/docs/cli/window/zoom Toggle a window's client-specific focus desktop --- # compozy worktree adopt URL: https://compozy.com/docs/cli/worktree/adopt Adopt an existing linked worktree --- # compozy worktree cancel URL: https://compozy.com/docs/cli/worktree/cancel Cancel a pending worktree creation --- # compozy worktree commit URL: https://compozy.com/docs/cli/worktree/commit Commit worktree changes --- # compozy worktree create URL: https://compozy.com/docs/cli/worktree/create Create a worktree --- # compozy worktree dismiss URL: https://compozy.com/docs/cli/worktree/dismiss Dismiss a worktree tombstone --- # compozy worktree exit-cancel URL: https://compozy.com/docs/cli/worktree/exit-cancel Cancel a running worktree exit action --- # compozy worktree exit URL: https://compozy.com/docs/cli/worktree/exit Read the worktree exit plan --- # compozy worktree URL: https://compozy.com/docs/cli/worktree Manage workspace worktrees --- # compozy worktree inspect URL: https://compozy.com/docs/cli/worktree/inspect Inspect a worktree --- # compozy worktree list URL: https://compozy.com/docs/cli/worktree/list List registered worktrees --- # compozy worktree pr URL: https://compozy.com/docs/cli/worktree/pr Open a pull request for the worktree --- # compozy worktree push URL: https://compozy.com/docs/cli/worktree/push Push the worktree branch --- # compozy worktree remove URL: https://compozy.com/docs/cli/worktree/remove Remove a worktree --- # compozy worktree status URL: https://compozy.com/docs/cli/worktree/status Read or refresh worktree status --- # compozy workspace add URL: https://compozy.com/docs/cli/workspace/add Register a workspace --- # compozy workspace edit URL: https://compozy.com/docs/cli/workspace/edit Edit a registered workspace --- # compozy workspace URL: https://compozy.com/docs/cli/workspace Manage registered workspaces --- # compozy workspace info URL: https://compozy.com/docs/cli/workspace/info Show one workspace with resolved details --- # compozy workspace list URL: https://compozy.com/docs/cli/workspace/list List registered workspaces --- # compozy workspace remove URL: https://compozy.com/docs/cli/workspace/remove Remove a workspace registration and stopped session history --- # Capability Discovery URL: https://compozy.com/docs/network/protocol/capability-discovery Wire-level reference for advertising capabilities, retrieving rich catalogs through whois, and transferring capability envelopes. --- # Conformance Levels URL: https://compozy.com/docs/network/protocol/conformance Reference for Compozy Network v0 Core roles, the optional v1 trust profile, required behavior, test coverage, and self-certification. --- # Delivery Guarantees URL: https://compozy.com/docs/network/protocol/delivery Reference for Compozy Network v0 validation, retry, ordering, deduplication, expiry, receipts, and transport independence. --- # Optional Ed25519 + JCS Trust Profile (v1) URL: https://compozy.com/docs/network/protocol/ed25519-jcs Reference for the optional RFC 004 v1 trust profile layered on compozy-network/v0; the current CompozyOS runtime does not implement its Ed25519 signing or verification. --- # Envelope Specification URL: https://compozy.com/docs/network/protocol/envelope Reference for the Compozy Network v0 JSON envelope, conversation surface fields, work lifecycle correlation, validation order, schema, and annotated examples. --- # End-to-End Examples URL: https://compozy.com/docs/network/protocol/examples Complete Compozy Network v0 examples for public thread coordination, restricted direct-room handoff, peer discovery, and capability transfer. --- # Implementation Status URL: https://compozy.com/docs/network/protocol/implementation-status What the CompozyOS reference implementation supports today for compozy-network/v0, including the unimplemented optional Ed25519 and JCS trust profile. --- # Compozy Network Protocol URL: https://compozy.com/docs/network/protocol Understand the transport-neutral wire model, build a peer, and evaluate conformance without confusing protocol semantics with CompozyOS participation policy. --- # Work Lifecycle URL: https://compozy.com/docs/network/protocol/interactions Reference for Compozy Network v0 work_id semantics, opening directed work, progress streaming, lifecycle states, conversation-container binding, and timeout rules. --- # Message Kinds URL: https://compozy.com/docs/network/protocol/message-kinds Reference for the six Compozy Network v0 message kinds, their conversation surface and work rules, required body fields, and JSON examples. --- # Protocol Overview URL: https://compozy.com/docs/network/protocol/overview Understand the transport-neutral Compozy Network envelope, how it differs from CompozyOS runtime policy, and where Local/Live participation fits. --- # Peer Discovery URL: https://compozy.com/docs/network/protocol/peer-discovery Reference for Compozy Network v0 Peer Cards, greet announcements, whois queries, channel-scoped presence, and capability advertisement. --- # Optional Signature Verification (v1) URL: https://compozy.com/docs/network/protocol/verification Reference for the optional RFC 004 v1 trust profile layered on compozy-network/v0; CompozyOS currently routes proof as opaque JSON and does not run this algorithm. --- # Worktree Model URL: https://compozy.com/docs/worktrees/concepts The ownership, identity, Git-truth, binding, and concurrency rules behind CompozyOS Worktrees. --- # compozy agent heartbeat delete URL: https://compozy.com/docs/cli/agent/heartbeat/delete Delete HEARTBEAT.md through managed authoring --- # compozy agent heartbeat history URL: https://compozy.com/docs/cli/agent/heartbeat/history List managed Heartbeat authoring revisions --- # compozy agent heartbeat URL: https://compozy.com/docs/cli/agent/heartbeat Inspect and manage agent HEARTBEAT.md files --- # compozy agent heartbeat inspect URL: https://compozy.com/docs/cli/agent/heartbeat/inspect Inspect one agent's resolved Heartbeat policy --- # compozy agent heartbeat rollback URL: https://compozy.com/docs/cli/agent/heartbeat/rollback Rollback HEARTBEAT.md to a managed revision or snapshot digest --- # compozy agent heartbeat status URL: https://compozy.com/docs/cli/agent/heartbeat/status Read Heartbeat policy status and wake eligibility --- # compozy agent heartbeat validate URL: https://compozy.com/docs/cli/agent/heartbeat/validate Validate a proposed Heartbeat policy body --- # compozy agent heartbeat wake URL: https://compozy.com/docs/cli/agent/heartbeat/wake Request one manual advisory Heartbeat wake --- # compozy agent heartbeat write URL: https://compozy.com/docs/cli/agent/heartbeat/write Create or replace HEARTBEAT.md through managed authoring --- # compozy agent soul delete URL: https://compozy.com/docs/cli/agent/soul/delete Delete SOUL.md through managed authoring --- # compozy agent soul history URL: https://compozy.com/docs/cli/agent/soul/history List managed Soul authoring revisions --- # compozy agent soul URL: https://compozy.com/docs/cli/agent/soul Inspect and manage agent SOUL.md files --- # compozy agent soul inspect URL: https://compozy.com/docs/cli/agent/soul/inspect Inspect one agent's resolved Soul --- # compozy agent soul rollback URL: https://compozy.com/docs/cli/agent/soul/rollback Rollback SOUL.md to a managed revision --- # compozy agent soul validate URL: https://compozy.com/docs/cli/agent/soul/validate Validate a proposed Soul body or the current SOUL.md --- # compozy agent soul write URL: https://compozy.com/docs/cli/agent/soul/write Create or replace SOUL.md through managed authoring --- # compozy automation jobs create URL: https://compozy.com/docs/cli/automation/jobs/create Create an automation job --- # compozy automation jobs delete URL: https://compozy.com/docs/cli/automation/jobs/delete Delete an automation job --- # compozy automation jobs get URL: https://compozy.com/docs/cli/automation/jobs/get Show one automation job --- # compozy automation jobs history URL: https://compozy.com/docs/cli/automation/jobs/history Show run history for one automation job --- # compozy automation jobs URL: https://compozy.com/docs/cli/automation/jobs Manage automation jobs --- # compozy automation jobs trigger URL: https://compozy.com/docs/cli/automation/jobs/trigger Force an immediate automation job run --- # compozy automation jobs update URL: https://compozy.com/docs/cli/automation/jobs/update Update an automation job --- # compozy automation suggestions accept URL: https://compozy.com/docs/cli/automation/suggestions/accept Accept a suggestion and create its Job --- # compozy automation suggestions dismiss URL: https://compozy.com/docs/cli/automation/suggestions/dismiss Dismiss an automation suggestion --- # compozy automation suggestions URL: https://compozy.com/docs/cli/automation/suggestions Review consent-first automation suggestions --- # compozy automation triggers create URL: https://compozy.com/docs/cli/automation/triggers/create Create an automation trigger --- # compozy automation triggers delete URL: https://compozy.com/docs/cli/automation/triggers/delete Delete an automation trigger --- # compozy automation triggers get URL: https://compozy.com/docs/cli/automation/triggers/get Show one automation trigger --- # compozy automation triggers history URL: https://compozy.com/docs/cli/automation/triggers/history Show run history for one automation trigger --- # compozy automation triggers URL: https://compozy.com/docs/cli/automation/triggers Manage automation triggers --- # compozy automation triggers update URL: https://compozy.com/docs/cli/automation/triggers/update Update an automation trigger --- # compozy automation runs get URL: https://compozy.com/docs/cli/automation/runs/get Show one automation run --- # compozy automation runs URL: https://compozy.com/docs/cli/automation/runs Inspect automation run history --- # compozy bridge manifest URL: https://compozy.com/docs/cli/bridge/manifest Generate provider setup artifacts --- # compozy bridge manifest slack URL: https://compozy.com/docs/cli/bridge/manifest/slack Generate a Slack app manifest for one bridge instance --- # compozy bridge setup discord URL: https://compozy.com/docs/cli/bridge/setup/discord Configure a discord bridge --- # compozy bridge setup URL: https://compozy.com/docs/cli/bridge/setup Configure a bridge instance and its write-only secrets --- # compozy bridge setup telegram URL: https://compozy.com/docs/cli/bridge/setup/telegram Configure a telegram bridge --- # compozy bridge setup whatsapp URL: https://compozy.com/docs/cli/bridge/setup/whatsapp Configure a whatsapp bridge --- # compozy bridge secret-bindings delete URL: https://compozy.com/docs/cli/bridge/secret-bindings/delete Delete one bridge secret binding --- # compozy bridge secret-bindings URL: https://compozy.com/docs/cli/bridge/secret-bindings Manage bridge secret bindings --- # compozy bridge secret-bindings list URL: https://compozy.com/docs/cli/bridge/secret-bindings/list List secret bindings for one bridge instance --- # compozy bridge secret-bindings put URL: https://compozy.com/docs/cli/bridge/secret-bindings/put Create or update one bridge secret binding --- # compozy desktop clients URL: https://compozy.com/docs/cli/desktop/clients Manage connected window-manager clients --- # compozy desktop clients list URL: https://compozy.com/docs/cli/desktop/clients/list List connected client-local desktop views --- # compozy desktop clients register URL: https://compozy.com/docs/cli/desktop/clients/register Register or refresh a client-local desktop view --- # compozy desktop clients unregister URL: https://compozy.com/docs/cli/desktop/clients/unregister Remove a connected client-local view --- # compozy gateway provider disable URL: https://compozy.com/docs/cli/gateway/provider/disable Disable a connectivity provider for one tier --- # compozy gateway provider enable URL: https://compozy.com/docs/cli/gateway/provider/enable Enable a connectivity provider for one tier --- # compozy gateway provider URL: https://compozy.com/docs/cli/gateway/provider Manage connectivity providers --- # compozy gateway surface disable URL: https://compozy.com/docs/cli/gateway/surface/disable Disable one gateway surface --- # compozy gateway surface enable URL: https://compozy.com/docs/cli/gateway/surface/enable Enable one gateway surface --- # compozy gateway surface URL: https://compozy.com/docs/cli/gateway/surface Manage gateway surface exposure --- # compozy extension secrets bind URL: https://compozy.com/docs/cli/extension/secrets/bind Bind one declared environment name to an existing extension Vault ref --- # compozy extension secrets URL: https://compozy.com/docs/cli/extension/secrets Manage write-only extension environment bindings --- # compozy extension secrets list URL: https://compozy.com/docs/cli/extension/secrets/list List declared and bound environment names without values --- # compozy extension secrets set URL: https://compozy.com/docs/cli/extension/secrets/set Set one declared extension secret from hidden input --- # compozy extension secrets unset URL: https://compozy.com/docs/cli/extension/secrets/unset Remove one extension environment binding --- # compozy loop node cancel URL: https://compozy.com/docs/cli/loop/node/cancel Cancel one Loop node --- # compozy loop node URL: https://compozy.com/docs/cli/loop/node Manage one authored Loop node --- # compozy loop node kill URL: https://compozy.com/docs/cli/loop/node/kill Kill one Loop node --- # compozy loop node pause URL: https://compozy.com/docs/cli/loop/node/pause Pause one Loop node --- # compozy loop node requeue URL: https://compozy.com/docs/cli/loop/node/requeue Requeue one quarantined Loop node --- # compozy loop node resume URL: https://compozy.com/docs/cli/loop/node/resume Resume one Loop node or manual wait --- # compozy mcp auth URL: https://compozy.com/docs/cli/mcp/auth Authenticate remote MCP servers through the daemon --- # compozy mcp auth login URL: https://compozy.com/docs/cli/mcp/auth/login Authorize a remote MCP server through the daemon --- # compozy mcp auth logout URL: https://compozy.com/docs/cli/mcp/auth/logout Revoke or delete remote MCP auth tokens through the daemon --- # compozy mcp auth status URL: https://compozy.com/docs/cli/mcp/auth/status Show redacted remote MCP auth status --- # compozy network channels create URL: https://compozy.com/docs/cli/network/channels/create Create a runtime channel and start one session per selected agent --- # compozy network channels URL: https://compozy.com/docs/cli/network/channels List active runtime channels --- # compozy network channels update URL: https://compozy.com/docs/cli/network/channels/update Update runtime channel routing metadata --- # compozy network coordination disable URL: https://compozy.com/docs/cli/network/coordination/disable Disable workspace coordination conversations --- # compozy network coordination enable URL: https://compozy.com/docs/cli/network/coordination/enable Enable workspace coordination conversations --- # compozy network coordination URL: https://compozy.com/docs/cli/network/coordination Inspect or change workspace network coordination --- # compozy network coordination status URL: https://compozy.com/docs/cli/network/coordination/status Show workspace network coordination and invitation state --- # compozy network directs URL: https://compozy.com/docs/cli/network/directs Inspect restricted direct rooms --- # compozy network directs list URL: https://compozy.com/docs/cli/network/directs/list List direct rooms in a channel --- # compozy network directs messages URL: https://compozy.com/docs/cli/network/directs/messages List messages in one direct room --- # compozy network directs resolve URL: https://compozy.com/docs/cli/network/directs/resolve Create or return the deterministic direct room for two peers --- # compozy network directs show URL: https://compozy.com/docs/cli/network/directs/show Show one direct room --- # compozy network invitation dismiss URL: https://compozy.com/docs/cli/network/invitation/dismiss Dismiss the coordination invitation for a scope --- # compozy network invitation URL: https://compozy.com/docs/cli/network/invitation Dismiss or reset the coordination invitation --- # compozy network invitation reset URL: https://compozy.com/docs/cli/network/invitation/reset Reset the coordination invitation for a scope --- # compozy network subscriptions URL: https://compozy.com/docs/cli/network/subscriptions Inspect network delivery preferences --- # compozy network subscriptions list URL: https://compozy.com/docs/cli/network/subscriptions/list List network delivery preferences --- # compozy network threads URL: https://compozy.com/docs/cli/network/threads Inspect public network threads --- # compozy network threads list URL: https://compozy.com/docs/cli/network/threads/list List public threads in a channel --- # compozy network threads messages URL: https://compozy.com/docs/cli/network/threads/messages List messages in one public thread --- # compozy network threads promote URL: https://compozy.com/docs/cli/network/threads/promote Promote one thread message into a durable task --- # compozy network threads show URL: https://compozy.com/docs/cli/network/threads/show Show one public thread --- # compozy network work URL: https://compozy.com/docs/cli/network/work Inspect lifecycle-bearing network work --- # compozy network work lookup URL: https://compozy.com/docs/cli/network/work/lookup Show one network work item --- # compozy memory adhoc URL: https://compozy.com/docs/cli/memory/adhoc Inspect ad-hoc Memory v2 notes --- # compozy memory adhoc list URL: https://compozy.com/docs/cli/memory/adhoc/list Reserved Memory v2 command --- # compozy memory adhoc show URL: https://compozy.com/docs/cli/memory/adhoc/show Reserved Memory v2 command --- # compozy memory daily archive URL: https://compozy.com/docs/cli/memory/daily/archive Reserved Memory v2 command --- # compozy memory daily URL: https://compozy.com/docs/cli/memory/daily Inspect Memory v2 daily operation logs --- # compozy memory daily ls URL: https://compozy.com/docs/cli/memory/daily/ls List Memory v2 daily operation logs --- # compozy memory daily purge URL: https://compozy.com/docs/cli/memory/daily/purge Reserved Memory v2 command --- # compozy memory daily restore URL: https://compozy.com/docs/cli/memory/daily/restore Reserved Memory v2 command --- # compozy memory daily show URL: https://compozy.com/docs/cli/memory/daily/show Reserved Memory v2 command --- # compozy memory dream URL: https://compozy.com/docs/cli/memory/dream Operate Memory v2 dreaming runs --- # compozy memory dream retry URL: https://compozy.com/docs/cli/memory/dream/retry Retry one failed Memory v2 dreaming run --- # compozy memory dream show URL: https://compozy.com/docs/cli/memory/dream/show Show one Memory v2 dreaming run --- # compozy memory dream status URL: https://compozy.com/docs/cli/memory/dream/status Show Memory v2 dreaming runtime status --- # compozy memory dream trigger URL: https://compozy.com/docs/cli/memory/dream/trigger Trigger Memory v2 dreaming --- # compozy memory extractor disable URL: https://compozy.com/docs/cli/memory/extractor/disable Reserved Memory v2 command --- # compozy memory extractor drain URL: https://compozy.com/docs/cli/memory/extractor/drain Drain Memory v2 extractor work --- # compozy memory extractor URL: https://compozy.com/docs/cli/memory/extractor Operate Memory v2 extractor runtime --- # compozy memory extractor list-failures URL: https://compozy.com/docs/cli/memory/extractor/list-failures List Memory v2 extractor failure records --- # compozy memory extractor replay URL: https://compozy.com/docs/cli/memory/extractor/replay Replay Memory v2 extractor work --- # compozy memory extractor status URL: https://compozy.com/docs/cli/memory/extractor/status Show Memory v2 extractor runtime status --- # compozy memory decisions URL: https://compozy.com/docs/cli/memory/decisions Inspect and revert Memory v2 controller decisions --- # compozy memory decisions list URL: https://compozy.com/docs/cli/memory/decisions/list List Memory v2 controller decisions --- # compozy memory decisions revert URL: https://compozy.com/docs/cli/memory/decisions/revert Revert one Memory v2 controller decision --- # compozy memory decisions show URL: https://compozy.com/docs/cli/memory/decisions/show Show one Memory v2 controller decision --- # compozy memory provider disable URL: https://compozy.com/docs/cli/memory/provider/disable Disable one Memory v2 provider --- # compozy memory provider enable URL: https://compozy.com/docs/cli/memory/provider/enable Enable and select one Memory v2 provider --- # compozy memory provider URL: https://compozy.com/docs/cli/memory/provider Operate Memory v2 providers --- # compozy memory provider list URL: https://compozy.com/docs/cli/memory/provider/list List registered Memory v2 providers --- # compozy memory recall URL: https://compozy.com/docs/cli/memory/recall Inspect Memory v2 recall traces --- # compozy memory recall trace URL: https://compozy.com/docs/cli/memory/recall/trace Show one redaction-safe recall trace --- # compozy notifications preset create URL: https://compozy.com/docs/cli/notifications/preset/create Create a notification preset --- # compozy notifications preset delete URL: https://compozy.com/docs/cli/notifications/preset/delete Delete a custom notification preset --- # compozy notifications preset disable URL: https://compozy.com/docs/cli/notifications/preset/disable Disable a notification preset --- # compozy notifications preset enable URL: https://compozy.com/docs/cli/notifications/preset/enable Enable a notification preset --- # compozy notifications preset URL: https://compozy.com/docs/cli/notifications/preset Manage one notification preset --- # compozy notifications preset show URL: https://compozy.com/docs/cli/notifications/preset/show Show one notification preset --- # compozy notifications preset update URL: https://compozy.com/docs/cli/notifications/preset/update Update a notification preset --- # compozy notifications presets URL: https://compozy.com/docs/cli/notifications/presets List notification presets --- # compozy notifications presets list URL: https://compozy.com/docs/cli/notifications/presets/list List notification presets --- # compozy provider auth URL: https://compozy.com/docs/cli/provider/auth Inspect native CLI and bound-secret provider authentication --- # compozy provider auth login URL: https://compozy.com/docs/cli/provider/auth/login Run the provider native login command locally --- # compozy provider auth status URL: https://compozy.com/docs/cli/provider/auth/status Show provider authentication status --- # compozy provider models URL: https://compozy.com/docs/cli/provider/models Inspect and refresh the provider model catalog --- # compozy provider models list URL: https://compozy.com/docs/cli/provider/models/list List provider model catalog entries --- # compozy provider models refresh URL: https://compozy.com/docs/cli/provider/models/refresh Refresh provider model catalog sources --- # compozy provider models set URL: https://compozy.com/docs/cli/provider/models/set Curate one provider model --- # compozy provider models status URL: https://compozy.com/docs/cli/provider/models/status Show provider model catalog source status --- # compozy session attachments URL: https://compozy.com/docs/cli/session/attachments Manage session attachments --- # compozy session attachments upload URL: https://compozy.com/docs/cli/session/attachments/upload Upload a file to a session --- # compozy session clarify answer URL: https://compozy.com/docs/cli/session/clarify/answer Answer one live session question --- # compozy session clarify URL: https://compozy.com/docs/cli/session/clarify Manage live session questions --- # compozy session clarify pending URL: https://compozy.com/docs/cli/session/clarify/pending List live questions awaiting an operator answer --- # compozy session input cancel URL: https://compozy.com/docs/cli/session/input/cancel Cancel one queued session input --- # compozy session input edit URL: https://compozy.com/docs/cli/session/input/edit Replace one queued session input --- # compozy session input URL: https://compozy.com/docs/cli/session/input Manage pending session input --- # compozy session input list URL: https://compozy.com/docs/cli/session/input/list List pending input for a session --- # compozy session input steer URL: https://compozy.com/docs/cli/session/input/steer Promote queued input to fenced steering guidance --- # compozy session runtime clear URL: https://compozy.com/docs/cli/session/runtime/clear Clear the default runtime for future prompts --- # compozy session runtime URL: https://compozy.com/docs/cli/session/runtime Manage the default runtime for future session prompts --- # compozy session runtime set URL: https://compozy.com/docs/cli/session/runtime/set Select the default runtime for future prompts --- # compozy session soul URL: https://compozy.com/docs/cli/session/soul Manage session Soul snapshots --- # compozy session soul refresh URL: https://compozy.com/docs/cli/session/soul/refresh Refresh an idle session's Soul snapshot --- # compozy tool approvals URL: https://compozy.com/docs/cli/tool/approvals Manage remembered native-tool approval decisions --- # compozy tool approvals list URL: https://compozy.com/docs/cli/tool/approvals/list List remembered native-tool approval decisions --- # compozy tool approvals revoke URL: https://compozy.com/docs/cli/tool/approvals/revoke Revoke one remembered native-tool approval decision --- # compozy tool approvals set URL: https://compozy.com/docs/cli/tool/approvals/set Set an explicit agent-wide or tool-wide approval decision --- # compozy tool artifact URL: https://compozy.com/docs/cli/tool/artifact Read retained oversized tool results --- # compozy tool artifact read URL: https://compozy.com/docs/cli/tool/artifact/read Read one workspace-scoped artifact page --- # compozy task child create URL: https://compozy.com/docs/cli/task/child/create Create a child task beneath a parent --- # compozy task child URL: https://compozy.com/docs/cli/task/child Manage child tasks --- # compozy task dependency add URL: https://compozy.com/docs/cli/task/dependency/add Add a dependency edge to a task --- # compozy task dependency URL: https://compozy.com/docs/cli/task/dependency Manage task dependencies --- # compozy task dependency remove URL: https://compozy.com/docs/cli/task/dependency/remove Remove a dependency edge from a task --- # compozy task notification delete URL: https://compozy.com/docs/cli/task/notification/delete Delete one bridge terminal notification subscription --- # compozy task notification URL: https://compozy.com/docs/cli/task/notification Manage task terminal notifications --- # compozy task notification list URL: https://compozy.com/docs/cli/task/notification/list List bridge terminal notification subscriptions for one task --- # compozy task notification show URL: https://compozy.com/docs/cli/task/notification/show Show one bridge terminal notification subscription --- # compozy task notification subscribe URL: https://compozy.com/docs/cli/task/notification/subscribe Subscribe a bridge target to task terminal notifications --- # compozy task profile delete URL: https://compozy.com/docs/cli/task/profile/delete Delete one task execution profile --- # compozy task profile URL: https://compozy.com/docs/cli/task/profile Manage task execution profiles --- # compozy task profile inspect URL: https://compozy.com/docs/cli/task/profile/inspect Show one task execution profile --- # compozy task profile set-worktree URL: https://compozy.com/docs/cli/task/profile/set-worktree Set a task worktree policy --- # compozy task profile update URL: https://compozy.com/docs/cli/task/profile/update Replace one task execution profile --- # compozy task run attach-session URL: https://compozy.com/docs/cli/task/run/attach-session Attach an existing session to a claimed or starting run --- # compozy task run cancel URL: https://compozy.com/docs/cli/task/run/cancel Cancel a task run --- # compozy task run complete URL: https://compozy.com/docs/cli/task/run/complete Complete a running task run --- # compozy task run enqueue URL: https://compozy.com/docs/cli/task/run/enqueue Enqueue a task run --- # compozy task run fail URL: https://compozy.com/docs/cli/task/run/fail Fail a task run --- # compozy task run URL: https://compozy.com/docs/cli/task/run Manage task runs --- # compozy task run list URL: https://compozy.com/docs/cli/task/run/list List runs for a task --- # compozy task run recover URL: https://compozy.com/docs/cli/task/run/recover Recover one needs_attention task run --- # compozy task run show URL: https://compozy.com/docs/cli/task/run/show Show a task run --- # compozy task run start URL: https://compozy.com/docs/cli/task/run/start Start a claimed task run --- # compozy task review URL: https://compozy.com/docs/cli/task/review Manage task-run reviews --- # compozy task review list URL: https://compozy.com/docs/cli/task/review/list List task-run reviews --- # compozy task review request URL: https://compozy.com/docs/cli/task/review/request Request review for a task run --- # compozy task review show URL: https://compozy.com/docs/cli/task/review/show Show one task-run review --- # compozy task review submit URL: https://compozy.com/docs/cli/task/review/submit Submit one task-run review verdict --- # Implementation Guide URL: https://compozy.com/docs/network/protocol/guide Build a Compozy Network peer from the wire model — construct and validate an envelope, decide whether the optional v1 trust profile applies, then test what you claim. --- # Minimal Sender URL: https://compozy.com/docs/network/protocol/guide/minimal-sender Build the smallest Compozy Network sender by constructing and validating one envelope before choosing a carrier. --- # Testing Your Implementation URL: https://compozy.com/docs/network/protocol/guide/testing Test Compozy Network v0 envelopes, lifecycle, your implementation-owned carrier, and the optional v1 trust profile only when you claim it. --- # Optional Trust Verification Walkthrough (v1) URL: https://compozy.com/docs/network/protocol/guide/trust-verification Explore the optional RFC 004 v1 Ed25519 and JCS profile with an illustrative proof-only demo; CompozyOS does not currently implement this verifier. --- # Changelog v0.3.0-beta.16 Published: 2026-08-14T18:23:42Z ## 0.3.0-beta.16 - 2026-08-14 ### ♻️ Refactoring - Add global workspace toggle (#368) ### 🐛 Bug Fixes - Harden desktop startup and diagnostics (#343) - Resolve desktop and session usability issues (#351) - Recover canceled Loop coordinators on restart (#353) - Resolve extension-published agents for session command catalogs (#350) - Eliminate persistent performance bottlenecks (#354) - Reject automation trigger events no producer emits (#358) - Read loop watch-events with a stream-global cursor (#356) - Prevent session timeline render loops (#361) - Align update artifacts with release policy (#363) - Canonicalize desktop runtime manifests (#364) - Validate desktop bundles before release - Make release publication atomic - Defer npm publication safely - Harden release recovery - Isolate release publishers - Make release artifacts reproducible - Align release automation contracts - Reject invalid agent names (#367) - Resolve extension agent skills and missing config paths (#372) - Include extension tools in hosted MCP bootstrap (#373) - Use conventional release triggers - Resolve main lint regressions - Parse nanosecond daemon timestamps - Validate release workflow tools by type - Preserve awaited child loop state (#391) - Use exact Cursor ACP model values (#392) - Preserve dead session history (#393) - Validate desktop release smoke wiring - Validate public CLI version command - Clarify missing config path errors (#401) ### 🧪 Testing - Align dead session recovery coverage --- # Changelog v0.3.0-beta.13 Published: 2026-08-11T12:04:23Z ## 0.3.0-beta.13 - 2026-08-11 ### 🐛 Bug Fixes - Publish staged GitHub release drafts - Repair release integration contracts --- # Changelog v0.3.0-beta.12 Published: 2026-08-11T05:19:23Z ## 0.3.0-beta.12 - 2026-08-11 ### 🎉 Features - Ship CompozyOS desktop app (#336) ### 🐛 Bug Fixes - Make loop goals converge reliably (#335) - Desktop issues - Ship the full desktop icon set required by Windows tauri-build - Pause the Windows desktop lane and ship macOS + Linux only - Adjust project copy --- # Changelog v0.3.0-beta.8 Published: 2026-08-10T01:13:08Z ## 0.3.0-beta.8 - 2026-08-10 ### ♻️ Refactoring - Use geist instead of inter (#334) ### 🎉 Features - Add secure remote gateway access (#331) ### 🐛 Bug Fixes - Judge gate on goal loops - Restore minimum-age dependencies - Stabilize release runtime startup - Start absent SSH daemon ### 🧪 Testing - Align nightly runtime fixtures ### Release Notes #### Features ##### Bundled Tailscale connectivity extension Gateway reachability ships with a first-party provider. The `tailscale` extension runs a Tailscale node inside the Compozy process through `tsnet`, against the operator's own account — nothing else to install, and Compozy operates no relay, server, or account on anyone's behalf. The private tier serves `https://compozy-gateway..ts.net:8443` on the tailnet; the public tier serves the same hostname over Tailscale Funnel on 443. (#331) - Bind the auth key once with `compozy extension secrets set tailscale --env TS_AUTHKEY` (hidden input); the value never appears in output, status, or diagnostics. - The extension declares required Live network participation for `gateway.private` and `gateway.public`, so enabling asks for a one-time digest confirmation — and asks again only when that declaration changes. - First activation provisions the HTTPS certificate before the Funnel listener opens, verifies public endpoints through authenticated DNS-over-TLS (`gateway.verify.public_dns_resolver`), and keeps unverified listeners staged with bounded retries instead of tearing them down. - Third-party providers implement the same `connectivity.provider` contract from the Go and TypeScript SDKs, gated by install-source trust and control-digest re-confirmation on every enable and boot. ##### Remote gateway: reach your daemon from anywhere A fresh install is still reachable only from the machine it runs on — and now that is a choice instead of a limitation. The remote gateway adds three independent, off-by-default switches: a private overlay that serves the full product to devices you pair over your own Tailscale network, a public delivery ingress that accepts only signed webhook and bridge callbacks, and consent-gated public operator access for devices that cannot join the overlay. (#331) - The daemon never binds a public address. Gateway tier listeners stay on loopback and a connectivity provider publishes a verified route to them: an address is advertised only after the daemon fetches a one-time challenge through it and gets its own nonce back. - Reaching an address is never authentication. Devices pair with single-use, five-minute artifacts written to private `0600` files, credentials are stored only as hashes, and `compozy device revoke` cancels live streams before it returns. - `compozy gateway status|audit`, `compozy pair`, `compozy device`, and `compozy connect` (HTTPS profiles plus zero-exposure SSH) operate everything, with the same state in **Settings → Gateway** and the `compozy__gateway` native tool. - Public delivery verifies Compozy's timestamped HMAC contract on every request, with replay protection and per-source rate limits. There is no store-and-forward while the daemon is offline — senders own retries. Setup guides live in the new Gateway docs section: https://compozy.com/docs/gateway. #### Highlights ##### Gateway docs: zero to GitHub webhooks compozy.com gains a dedicated Gateway section written for first-time operators: a ten-minute quickstart from `gateway.enabled` to a paired phone, a step-by-step "Receive GitHub webhooks" tutorial verified end to end — including why a native repository webhook cannot sign Compozy's generic trigger contract and the GitHub Actions workflow that can — a Tailscale extension page covering tailnet prerequisites through clean removal, a remote CLI/SSH/public-access guide, a devices-audit-teardown runbook, and a plain-language security page. (#331) Migration notes: `/docs/operations/remote-gateway`, `/docs/operations/gateway-threat-model`, and `/docs/configuration/gateway` moved into `/docs/gateway/*` as a hard cut — update saved links. --- # Changelog v0.3.0-beta.7 Published: 2026-08-08T03:16:35Z ## 0.3.0-beta.7 - 2026-08-08 ### 🐛 Bug Fixes - Session native tools and extensions details (#330) --- # Changelog v0.3.0-beta.6 Published: 2026-08-07T18:58:19Z ## 0.3.0-beta.6 - 2026-08-07 ### 🎉 Features - Replace software-delivery with implement-tasks (#325) - **BREAKING:** remove software-delivery; use implement-tasks without gate inputs. - Parent and child sessions (#327) ### 🐛 Bug Fixes - Preserve Loop template manifests across hydration (#317) - Preserve ACP stream disconnect recovery (#319) - Discover Cursor model catalog before sessions (#320) - Keep managed skill loading on native seam (#323) - Loop run bugs (#324) - Enforce bundled agent and Loop ownership (#326) ### 🧪 Testing - Guard ACP initialize protocol version (#318) ### Release Notes #### Breaking Changes ##### implement-tasks replaces the software-delivery Loop The bundled dev-cycle Loop now does one job clearly: implement authored task files in dependency order. `software-delivery` is gone and `implement-tasks` takes its place, with a five-node graph — `slug_input → load_tasks → implement → execute_task → collect` — and only three inputs. The old second control layer for review, command verification, and human approval is removed from the bundled Loop; task-level validation, self-review, tracking updates, and optional per-task commits stay inside the implementation agent's own prompt. (#325) - Inputs are now `slug`, `implementer`, and `auto_commit`. The `review`, `verify`, and `approve` nodes and their edges are deleted, along with the verification contract, stale hash fields, and target-branch handling. - The separate bundled `review-and-fix` Loop is unchanged, and custom Loops can still declare their own command gates — `verify_command` remains part of the generic Loop DSL. - The catalog, Loop overview, configuration examples, migration guide, web routes, and the official Compozy skill all name `implement-tasks`. Migration notes: this is a hard cut with no alias. Any config, CLI or API call, automation binding, or documentation link that says `software-delivery` must say `implement-tasks`, and the `target_branch` and `verify_command` inputs must be dropped from `[loops.inputs.*]`. ```toml # before [loops.inputs.software-delivery] target_branch = "main" verify_command = "make gate" auto_commit = false # after [loops.inputs.implement-tasks] auto_commit = false ``` #### Features ##### Cursor models come from your account Cursor used to look curated in Compozy but was not truthful to the account that was signed in: a small hand-written list stood in for the real catalog and, worse, acted as an allowlist that rejected valid model ids before Cursor ever saw them. Compozy now reads the account catalog from `cursor-agent models` before a session exists, and exact provider model ids are forwarded unchanged. (#320) - The first catalog read bootstraps Cursor discovery once and persists the outcome; later reads serve the cache, and explicit refresh is the refresh boundary. In the QA account this surfaced 193 real models, including `composer-2.5`. - Only `id - display name` rows are parsed. Headings, tips, duplicates, and empty output can never become invented models. - Curated data is metadata again, not membership policy. Sessions and Loops accept ids like `cursor/composer-2.5`, and an unknown _provider_ still fails with a structured `unknown_provider` error. - `providers..models.discovery` applies live — no daemon restart. A provider outage records the failure and keeps the rows you already have; disabling discovery clears them and records `disabled`. - In the web runtime selector, "Use an exact custom model ID…" now opens a dedicated field: empty input cannot be committed, typing turns the action into `Use ""`, Enter and click both commit, and closing returns to normal catalog search. - Cursor keeps the operator `HOME` its `native_cli` login contract expects. Migration notes: the curated Cursor allowlist and its session preflight are deleted with no compatibility bridge. If a provider rejects an id, that provider's error is now the authority. #### Fixes ##### A crashed agent no longer looks like a finished one When an agent process disconnected mid-answer, the stream simply ended — and everything downstream read that silence as success. A CLI consumer reached end of file and exited zero, `compozy__session_prompt` returned a result, and the only evidence left behind was stderr with no exit code. Streams are now fail-closed: success requires an explicit completion event, and disconnect, terminal error, and process exit stay three distinct outcomes. (#315, #319) - Chunks already received stay persisted and visible. Compozy never synthesizes a completion for them. - A stream that ends after partial output without a completion event fails the CLI with a clear non-zero exit, and terminal error frames are forwarded before the error is returned so machine-readable diagnostics survive. - `compozy__session_prompt` classifies a subprocess exit as `tool_backend_failed` with `backend_dead` instead of reporting success; the partial events remain readable in the session transcript. - Crash evidence now carries the subprocess exit code and, where the operating system exposes it, the terminating signal. - Fatal cleanup gives the process a bounded grace period to exit on its own before being stopped, so the real exit result is no longer lost to a race with forced teardown. - Compozy does not replay a prompt automatically, because a prompt may already have caused external side effects. Sending the next prompt restarts the agent process and continues the same session and transcript. Migration notes: crash bundles move to `compozy.session_crash_bundle.v2` with structured `exit_code` and `signal`, with no v1 branch. Any consumer that treated a closed stream as success will now correctly see a failure unless a completion event was sent. ##### Dry-run proves the run you are about to submit A Loop could validate, dry-run cleanly, and then fail at submission with `executed definition template manifest changed`. The compiler folded default values into the definition it stored, but compiled templates from the definition _before_ those defaults — so a persisted run carried more template keys than its own snapshot, and hydration rightly refused it. Compilation now uses one canonical definition throughout, and dry-run exercises the exact snapshot boundary a real submission uses. (#313, #317) - Defaults are folded once at the start of compilation and used for linting, contracts, nodes, watch events, graph metadata, and child Loops alike — so omitted child `mode` values no longer appear out of nowhere during hydration. - A snapshot must load through the production loader before its bytes or digest are returned; one that cannot round-trip can no longer reach storage. - `compozy loop run --dry-run` and `compozy__loop_run` with `dry: true` run that same check, so a preview can no longer approve a definition that submission would reject. - A mismatch now names the manifest kind, the exact key, and its source instead of reporting a generic failure. Migration notes: no storage, API, CLI, or configuration contract changed. Integrity checks were not relaxed — inconsistent definitions are still rejected, just earlier and with a readable reason. ##### Loop runs you can debug from the run page A Loop run that failed used to be a dead end: every attempt died with "The agent output did not satisfy the action output schema", the node was quarantined, "Open quarantine entry" opened an empty sheet, "Open session" returned 404, the cell task sat in "Queued · attempt 1 of 10" forever, and Usage confidently reported `0 / ~$0.00`. The agent had actually answered correctly every time — the daemon joined streamed text fragments with a newline, which landed inside a JSON string and corrupted a valid reply. That joiner is fixed, and so is every surface that made the failure impossible to read. (#324) - The agent now sees the authored `output_schema` in its prompt instead of prose that never said "JSON", extraction validates every candidate object newest-first (a quoted `package.json` no longer shadows the real answer), and the failure cause carries the underlying detail instead of one generic sentence. - Quarantine is routed to the node that actually failed. Parked consumers collapse into a single row — "**execute task is quarantined** — collect, review, verify and approve are parked behind it until it is requeued" — with one button that opens the producer's entry, and `node_attention_flagged` is finally emitted when a run parks. - Loop cells no longer stall in `ready` after a failed run: quarantine parks them as needs-attention and requeueing clears the park. The misleading `of 10` attempt ceiling is gone, since the Loop owns the retry budget. - Daemon-claimed runs stop writing placeholder session ids, the real ACP session is bound to the lease under a claim token, and run detail exposes `generations[].outputs[].session_id` — so "Open session" works from the hero and from every node row that has one. - The task list nests Loop cells under their coordinator with an escalation-first summary ("9 subtasks · 1 needs attention · 2 running") and readable identities like `g2.execute_task` instead of `loop.lo`. - When a provider reports no tokens, Usage now reads "not reported" and "—" instead of a confident zero; the cost estimate returns only when tokens exist. Migration notes: adds the `attention_producer_node_id` column to `loop_node_controls` through migration `00055`; run-detail payloads gain `node_controls[].attention_producer_node_id` and `generations[].outputs[].session_id`. ##### Skills load through the native seam inside managed sessions Managed sessions load installed skills through the native `compozy__skill_view` tool only — including skills that are not listed in the prompt catalog. The earlier attempt to give managed agents a private CLI socket is removed rather than kept as a fallback: provider code runs as the daemon user, so environment values, headers, process ancestry, and file modes cannot tell those requests apart from an operator's. (#314, #323) - If session policy denies the native tool, the agent reports the skill unavailable instead of shelling out or reading skill files directly. - Every `compozy skill` verb detects managed-session markers before doing any client, socket, registry, or filesystem work and points the caller at `compozy__skill_list`, `compozy__skill_search`, and `compozy__skill_view`. This is documented as a support guard, not an authorization boundary — same-user code can still clear those markers. - Hosted-MCP bind windows now start after ACP initialization and immediately before session negotiation. A cold provider launch that takes longer than the bind window no longer expires the tool seam before the agent can use it; a bind attempted before activation still fails closed. Migration notes: the managed CLI transport is deleted — the socket, `COMPOZY_AGENT_TRANSPORT_SOCKET`, the managed identity headers, and the managed skill API scope. Operator CLI behavior from a normal shell is unchanged. ##### One owner per Loop run, and cancellation that sticks Loop action runs now have exactly one daemon-owned worker, cancellation survives a restart, and a session that needs Compozy tools fails before the provider starts instead of running without them. Fresh Compozy homes also start with the bundled `dev-cycle` extension already enabled, while a home that has been booted before keeps whatever you chose. (#321, #322, #326) - Coordinators and ordinary task-role sessions can no longer activate or bootstrap a run that the dedicated `loop-action` executor already owns. - When the effective agent or lineage policy requires concrete tools and hosted MCP cannot provide them, session startup fails closed with `ErrHostedMCPUnavailable` before the provider process is launched. - Loop cancellation is durable: delivery state is persisted, delivery is idempotent, the run advances to draining once acknowledged, and anything still pending is retried from daemon boot and from scheduler sweeps — no restart required to converge. - Resuming a stopped session discards the stopped ledger projection first and restores it if provider startup or the clear rolls back, so forensic projections stop conflicting and the full history is rematerialized on the next stop. - Enablement of a bundled extension is a fresh-home default, not an override: generic local and marketplace installs stay disabled by default, and stored state survives restart and update. --- # Changelog v0.3.0-beta.5 Published: 2026-08-05T19:29:11Z ## 0.3.0-beta.5 - 2026-08-05 ### ♻️ Refactoring - Modernize Go runtime packages (#293) ### 🎉 Features - Rewind sessions to durable conversation checkpoints (#310) - Add session-aware slash skill commands (#311) - Add reversible session archiving and list actions (#309) ### 🐛 Bug Fixes - Restore durable ACP session continuity (#307) ### Release Notes #### Breaking Changes ##### Extension kits replace Bundles The Bundle surface is gone. Extensions are now the single packaging unit, and installing one is inert: it publishes no tools and no resources until you explicitly enable it. Before enabling, you can preview exactly what an extension would publish and inspect what it is publishing right now, and any extension that declares network access must have its network requirement digest confirmed by a person. (#291) - `compozy extension preview ` shows what enabling would publish without changing state; `compozy extension inventory ` shows the live published inventory. Agents get the same reads through `compozy__extensions_preview` and `compozy__extensions_inventory`. - `compozy extension enable|disable|update|install` accept `--confirm-network-requirement `, so a network-declaring extension cannot start publishing without an explicit confirmation recorded on the install. - `compozy extension secrets set|bind|list|unset` manages write-only environment bindings that are scoped per workspace and stored as secret references, never as values. - Marketplace kinds are now exactly `extension`, `mcp`, and `skill`. Migration notes: the whole `compozy bundle` command group is removed (`catalog`, `preview`, `activate`, `list`, `get`, `deactivate`, `network-settings`), along with the `compozy__bundles_*` native tools, the `compozy__bundles` toolset, the `bundle` marketplace kind, and the Bundle API surfaces. There is no alias — rebuild bundle-shaped setups as extensions and enable them explicitly. ##### Runtime hardening and secret-safe provider login A broad modernization pass across the Go runtime tightened lifecycle and cleanup ownership, ID allocation, task settlement, filesystem confinement, and streaming framing. Most of it is invisible, but it lands several deliberate cuts that change what operators, scripts, and agents see. (#293) - `providers..auth_login_command` is now write-only. You can still set it through `config.toml`, `compozy config set`, or `compozy__config_set`, but no read surface returns it. `compozy config show|list|get|diff`, provider status, doctor, Settings, HTTP, and UDS return a safe `login` descriptor instead: whether it is configured, its source, the executable basename, whether that executable is present, and a recommended action. - Every per-session event database carries an immutable owner and physical identity. A database that was copied between sessions or workspaces is refused before any migration or mutation — no adoption, no rebinding, no automatic repair. The operator recovery path is documented under "Session event store ownership". - Markdown files under `/knowledge/` are injected as a bounded workspace knowledge snapshot before each accepted turn, including task, task-creator, and Heartbeat wakes. It is prompt context for the turn, not durable memory. - Installing an extension from Git now requires Git 2.37 or newer and reports `extension_git_version_unsupported` when it is older. Git sources must be HTTPS and resolve to public addresses. Migration notes: `compozy provider auth login --print-command` is removed. The config key `memory.recall.signals.metrics_enabled` is removed with no alias. The task-notification native tools take `workspace_id` instead of `workspace`, and the old input is not an alias. Notification cursor identity and `delivery_id` are now opaque values that must be echoed back byte for byte. #### Features ##### Complete Loop node lifecycle Loops now have a full declarative failure contract at the node level and precise repair controls at the operator level. Authors classify failures, declare retries with backoff, route errors, absorb them with `allow_fail`, set attempt timeouts and deadlines, emit `on_*` effects, and add durable wait nodes. Operators pause, resume, cancel, kill, or requeue individual nodes and list what is waiting, quarantined, retrying, or asking for attention — all from the CLI, HTTP, UDS, native tools, and MCP, without opening the web UI. (#305) - `compozy loop cancel` drains a run safely and `compozy loop kill` closes it immediately; `compozy loop node pause|resume|cancel|kill|requeue` repairs a single node, and `compozy loop nodes --state waiting|quarantined|attention|retrying` inventories a run. - Agents get the same controls through `compozy__loop_cancel`, `compozy__loop_kill`, `compozy__loop_node_pause`, `compozy__loop_node_resume`, `compozy__loop_node_cancel`, `compozy__loop_node_kill`, `compozy__loop_node_requeue`, and `compozy__loop_nodes`; `compozy__loop_status` now reports node lifecycle state. - Repeated failure on one node quarantines that node instead of terminating the run, so independent lanes keep working, and the failure cause is classified rather than matched from a magic string. - Long-running Loop-bound sessions are no longer killed on elapsed time. Liveness is judged from real evidence, and prolonged silence raises attention instead of ending the work. - Defaults are tunable through `loops.defaults.delivery.*`, `loops.defaults.watch.*`, and `loops.breaker.*`, and new blocking lint rules reject invalid routes, impossible timing, malformed effects and waits, and watch sources without a stable identity. Migration notes: `compozy loop stop` is deleted — the CLI verb, the HTTP route, and the `compozy__loop_stop` native tool. Choose `cancel` or `kill` explicitly. Extension watch sources must now declare `event_key`; a source without a stable event identity is rejected before a run starts. ##### Feedback semantics for durable Loops A rejected Loop generation no longer restarts blind. The rejection is carried into the next attempt as context, only the producers responsible for it are re-run, and an opt-in ratchet keeps the best-scoring generation instead of losing it to a later regression. Every generation now records its origin, its parent, the gate verdict, the score, and the blocking issues inside claim-fenced transactions, so the CLI, HTTP, UDS, native tools, SSE, and the web UI all read the same durable run truth. (#290) - Loop templates can read `previous.*` (including `previous.generation` and `previous.route_causes`) and `best.*` to steer the next attempt from what actually failed. - Metric gates take a direction — `maximize` or `minimize` — plus a `min_delta` improvement threshold, so a regression is rejected deterministically. Invalid thresholds fail authoring with `metric_min_delta_invalid`. - `compozy__loop_status` and `compozy__loop_runs` project score, best generation, gate verdict, and generation origin and parentage; run detail, catalog, and recent-runs views render the same fields. - `compozy extension list` and `compozy extension status` accept `--workspace`, so agents can inspect workspace dev overlays without dropping to raw HTTP. Migration notes: this is a greenfield hard cut that discards existing Loop run history. The migration clears Loop runs, run events, gate decisions, generation outputs, goal turns and checkpoints, session bindings, and output blobs, along with the task and automation runs that referenced them. Export anything you need before upgrading. ##### Reversible session archiving and list actions A stopped session can now be archived so it leaves the default catalog without deleting anything. History, events, ledger, and the saved runtime choice stay readable, and unarchiving puts the session back exactly as it was — still stopped, so a normal prompt restarts it. Both session lists gained a row menu with state-aware Stop, Archive, Unarchive, and Delete, a delete confirmation, and a separate section for archived sessions. (#309) - `compozy session archive ` and `compozy session unarchive `, plus `compozy session list --archived` for archived only and `--include-archived` for both. Agents get `compozy__session_archive` and `compozy__session_unarchive`, and extensions get `sessions/archive` and `sessions/unarchive` under `session.write`. - The catalog contract takes `archive=exclude|only|include` and defaults to `exclude`, with exact filtered totals and cursor fingerprints. Archived sessions are excluded from normal metrics. - Archiving is stopped-only and idempotent. An archived session stays readable, but prompt, attach, and resume are refused until you unarchive it. Hard delete is unchanged, and archive stays catalog metadata rather than a lifecycle state. - Bridge providers now wait for HTTP route readiness before serving, which closes a startup race across the bundled Discord, Google Chat, GitHub, Linear, Slack, Teams, Telegram, and WhatsApp runtimes. Migration notes: existing sessions are unarchived, so nothing changes until you archive something. ##### Rewind a session to an earlier checkpoint You can now rewind an idle session back to one of your earlier messages instead of starting over. The selected message and everything after it leave the active transcript, the message text comes back as a composer draft, and the session continues under the same session ID with a fresh agent context rebuilt only from the part you kept. Rewind touches the conversation only — it does not undo file edits, tool effects, network activity, saved memory, or anything the provider already did outside Compozy — and the discarded events stay archived for audit. (#310) - `compozy session rewind ` picks the cut point with `--message-id` and reads the current transcript fences for you; scripts retrying a known request pass `--expected-generation`, `--expected-epoch`, and `--expected-max-sequence` together with the original `--idempotency-key`. Agents get `compozy__session_rewind`. - Retrying the same rewind with the same idempotency key returns the original result, and the response carries the `draft_text` that goes back into the composer. - A rewind is refused with a clear conflict — and without cutting the transcript — when the fence is stale, the session is busy, input is queued, an approval is pending, or the session is daemon-managed. It is serialized against clear, delete, repair, resume, and other prompt-producing operations. - In the web UI, the action appears on your own durable messages, requires an empty composer, confirms the side-effect boundary before it runs, and restores the draft afterward. - Reads take an `archive` selector: `compozy session events` and `compozy session history` accept `--archive active|archived|all`, and the same selector exists on the HTTP and UDS reads. Migration notes: `session events` and `session history` now default to `archive=active`. They previously returned archived rows alongside active ones — pass `--archive all` to keep the old behavior. ##### Session-aware slash commands Slash commands in the composer are now backed by a single daemon-owned catalog scoped to the exact session, and they work anywhere in a prompt rather than only at the start. Built-in and ACP control commands stay standalone, while a skill command can be dropped inline, repeated, and mixed with the text you already typed; the matched skill's full instructions are injected into that same turn. The same catalog is readable from the CLI, HTTP, UDS, and a native tool, so agents can discover what a session can actually run. (#311) - `compozy session commands ` lists the catalog, and agents read it with `compozy__command_list` in the `compozy__catalog` toolset. `compozy__skill_view` accepts a source-qualified `command_id` from that list. - The catalog groups Built-in, Agent, and Skills at the start of a prompt and shows only effective skills inline. A bare `/skill` resolves the effective winner across bundled, global, additional, workspace, and agent-local sources; extension skills use `/extension-id:skill` and marketplace skills use `/registry-id:skill`. - What is effective respects global and workspace scope, agent activation and disable lists, runtime disable overlays, enabled and disabled extension resources, workspace and session ownership, and live resource revisions. A `session_commands_changed` stream frame refreshes only the affected session. - Injection is bounded at 24 KB per skill and 64 KB per turn, and repeating the same skill activates it once. Invocations persist through admission, queueing, replay, transcript storage, and the UI, and queued ones are revalidated against the exact source before dispatch. - Slash activation is limited to human operator input. Agent-authored prompts and `compozy__session_prompt` keep slash-shaped text literal, and hooks can remove an admitted invocation but never add one. #### Fixes ##### Restart a stopped session and keep its runtime A stopped session used to be a dead end: the UI went read-only and the only way forward was creating a new one. Sending a normal prompt to a stopped session now restarts its agent process, reloads the retained provider history, and continues under the same session ID and transcript. The provider, model, reasoning effort, and speed you picked are stored on the session itself, so they survive a stop and a daemon restart instead of silently reverting to the default. (#307) - The lifecycle gained a `starting` state, and a normal prompt is the only operation that moves a stopped session back toward execution. `session resume` stays attach-only, and queue, steer, interrupt, and attach do not restart a session. - `compozy session runtime set ` takes `--provider`, `--model`, `--reasoning-effort`, and `--speed`, and `compozy session runtime clear ` drops the choice. Both fence on `--expected-revision` and report a conflict on a stale one. Agents get `compozy__session_runtime_set` and `compozy__session_runtime_clear`; extensions get `sessions/runtime/set` and `sessions/runtime/clear` under `session.write`. - Session reads expose `runtime.selected`, `runtime.effective`, and `runtime.selection_revision`. A prompt resolves its runtime from an explicit snapshot first, then the stored selection, then the current effective values, and an already-queued prompt keeps the snapshot it was accepted with. - The composer stays enabled for a stopped session, and closing a session window during a live turn no longer breaks the transcript view. Migration notes: the `Use as Goal` action on settled assistant messages is removed. `/goal` is the single entry point for Goals. ##### Durable inputs for busy sessions Queue, Steer, and Interrupt are now daemon-owned durable operations instead of client-side intent that could quietly disappear. An input is persisted before it is acknowledged, survives a refresh and a daemon restart, dispatches exactly once in FIFO order, and can be listed, edited, canceled, or promoted to steering by its entry ID from the CLI, HTTP, UDS, native tools, or the extension host. Disruptive changes are fenced against the turn you meant to change, so a stale client cannot interrupt a newer turn. (#304) - `compozy session prompt` accepts `--queue`, `--interrupt`, and `--steer`; `compozy session input list|edit|steer|cancel` manages pending input by its persisted ID. - The queue is readable and mutable over HTTP and UDS at `/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/queue`, including per-entry replace, steer, and cancel. - Agents get `compozy__session_inputs_list`, `compozy__session_input_replace`, `compozy__session_input_cancel`, and `compozy__session_input_promote`. - The composer clears only after the daemon acknowledges, a failure keeps your draft, and a refresh reconstructs pending input from the daemon. Queued, steered, interrupted, canceled, accepted, and dropped markers no longer render as warnings, and an expected ACP cancellation no longer appears in the transcript as a provider failure. Migration notes: the dedicated interrupt endpoint is removed — interrupt is now a prompt mode plus a fenced queue operation. The legacy ACP steer handler and the runtime steer source are removed, and the web client no longer mirrors the queue in local state. ##### Live changelog and composer fixes The changelog on `compozy.com` now reads published releases directly from GitHub at request time instead of depending on a bot pushing a generated page back into `main` after every release. Each release gets its own page with rendered Markdown, category sections, evidence, compare links, and downloadable assets, plus an RSS feed at `/changelog/feed.xml`, and releases now appear in site search, the sitemap, and the text feeds that agents read. (#292) - Typing in the session composer no longer swallows spaces. - A window-manager WebSocket upgrade that fails for a missing workspace now returns a proper preflight error frame, and the web client refreshes a stale workspace list when it sees that error instead of staying stuck. Migration notes: the release workflow no longer publishes a site changelog receipt commit, and the generator scripts behind it are removed. --- # Changelog v0.3.0-beta.4 Published: 2026-08-04T14:48:33Z ## 0.3.0-beta.4 - 2026-08-04 ### ♻️ Refactoring - Replace bundles with extension kits (#291) ### 🎉 Features - Adopt feedback semantics for durable Loops (#290) - Add complete Loop node lifecycle (#305) ### 🐛 Bug Fixes - Assistant-ui version - Changelog generation (#292) - Make busy-session inputs durable (#304) ### Release Notes #### Breaking Changes ##### Extension kits replace Bundles The Bundle surface is gone. Extensions are now the single packaging unit, and installing one is inert: it publishes no tools and no resources until you explicitly enable it. Before enabling, you can preview exactly what an extension would publish and inspect what it is publishing right now, and any extension that declares network access must have its network requirement digest confirmed by a person. (#291) - `compozy extension preview ` shows what enabling would publish without changing state; `compozy extension inventory ` shows the live published inventory. Agents get the same reads through `compozy__extensions_preview` and `compozy__extensions_inventory`. - `compozy extension enable|disable|update|install` accept `--confirm-network-requirement `, so a network-declaring extension cannot start publishing without an explicit confirmation recorded on the install. - `compozy extension secrets set|bind|list|unset` manages write-only environment bindings that are scoped per workspace and stored as secret references, never as values. - Marketplace kinds are now exactly `extension`, `mcp`, and `skill`. Migration notes: the whole `compozy bundle` command group is removed (`catalog`, `preview`, `activate`, `list`, `get`, `deactivate`, `network-settings`), along with the `compozy__bundles_*` native tools, the `compozy__bundles` toolset, the `bundle` marketplace kind, and the Bundle API surfaces. There is no alias — rebuild bundle-shaped setups as extensions and enable them explicitly. #### Features ##### Complete Loop node lifecycle Loops now have a full declarative failure contract at the node level and precise repair controls at the operator level. Authors classify failures, declare retries with backoff, route errors, absorb them with `allow_fail`, set attempt timeouts and deadlines, emit `on_*` effects, and add durable wait nodes. Operators pause, resume, cancel, kill, or requeue individual nodes and list what is waiting, quarantined, retrying, or asking for attention — all from the CLI, HTTP, UDS, native tools, and MCP, without opening the web UI. (#305) - `compozy loop cancel` drains a run safely and `compozy loop kill` closes it immediately; `compozy loop node pause|resume|cancel|kill|requeue` repairs a single node, and `compozy loop nodes --state waiting|quarantined|attention|retrying` inventories a run. - Agents get the same controls through `compozy__loop_cancel`, `compozy__loop_kill`, `compozy__loop_node_pause`, `compozy__loop_node_resume`, `compozy__loop_node_cancel`, `compozy__loop_node_kill`, `compozy__loop_node_requeue`, and `compozy__loop_nodes`; `compozy__loop_status` now reports node lifecycle state. - Repeated failure on one node quarantines that node instead of terminating the run, so independent lanes keep working, and the failure cause is classified rather than matched from a magic string. - Long-running Loop-bound sessions are no longer killed on elapsed time. Liveness is judged from real evidence, and prolonged silence raises attention instead of ending the work. - Defaults are tunable through `loops.defaults.delivery.*`, `loops.defaults.watch.*`, and `loops.breaker.*`, and new blocking lint rules reject invalid routes, impossible timing, malformed effects and waits, and watch sources without a stable identity. Migration notes: `compozy loop stop` is deleted — the CLI verb, the HTTP route, and the `compozy__loop_stop` native tool. Choose `cancel` or `kill` explicitly. Extension watch sources must now declare `event_key`; a source without a stable event identity is rejected before a run starts. ##### Feedback semantics for durable Loops A rejected Loop generation no longer restarts blind. The rejection is carried into the next attempt as context, only the producers responsible for it are re-run, and an opt-in ratchet keeps the best-scoring generation instead of losing it to a later regression. Every generation now records its origin, its parent, the gate verdict, the score, and the blocking issues inside claim-fenced transactions, so the CLI, HTTP, UDS, native tools, SSE, and the web UI all read the same durable run truth. (#290) - Loop templates can read `previous.*` (including `previous.generation` and `previous.route_causes`) and `best.*` to steer the next attempt from what actually failed. - Metric gates take a direction — `maximize` or `minimize` — plus a `min_delta` improvement threshold, so a regression is rejected deterministically. Invalid thresholds fail authoring with `metric_min_delta_invalid`. - `compozy__loop_status` and `compozy__loop_runs` project score, best generation, gate verdict, and generation origin and parentage; run detail, catalog, and recent-runs views render the same fields. - `compozy extension list` and `compozy extension status` accept `--workspace`, so agents can inspect workspace dev overlays without dropping to raw HTTP. Migration notes: this is a greenfield hard cut that discards existing Loop run history. The migration clears Loop runs, run events, gate decisions, generation outputs, goal turns and checkpoints, session bindings, and output blobs, along with the task and automation runs that referenced them. Export anything you need before upgrading. #### Fixes ##### Durable inputs for busy sessions Queue, Steer, and Interrupt are now daemon-owned durable operations instead of client-side intent that could quietly disappear. An input is persisted before it is acknowledged, survives a refresh and a daemon restart, dispatches exactly once in FIFO order, and can be listed, edited, canceled, or promoted to steering by its entry ID from the CLI, HTTP, UDS, native tools, or the extension host. Disruptive changes are fenced against the turn you meant to change, so a stale client cannot interrupt a newer turn. (#304) - `compozy session prompt` accepts `--queue`, `--interrupt`, and `--steer`; `compozy session input list|edit|steer|cancel` manages pending input by its persisted ID. - The queue is readable and mutable over HTTP and UDS at `/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/queue`, including per-entry replace, steer, and cancel. - Agents get `compozy__session_inputs_list`, `compozy__session_input_replace`, `compozy__session_input_cancel`, and `compozy__session_input_promote`. - The composer clears only after the daemon acknowledges, a failure keeps your draft, and a refresh reconstructs pending input from the daemon. Queued, steered, interrupted, canceled, accepted, and dropped markers no longer render as warnings, and an expected ACP cancellation no longer appears in the transcript as a provider failure. Migration notes: the dedicated interrupt endpoint is removed — interrupt is now a prompt mode plus a fenced queue operation. The legacy ACP steer handler and the runtime steer source are removed, and the web client no longer mirrors the queue in local state. ##### Live changelog and composer fixes The changelog on `compozy.com` now reads published releases directly from GitHub at request time instead of depending on a bot pushing a generated page back into `main` after every release. Each release gets its own page with rendered Markdown, category sections, evidence, compare links, and downloadable assets, plus an RSS feed at `/changelog/feed.xml`, and releases now appear in site search, the sitemap, and the text feeds that agents read. (#292) - Typing in the session composer no longer swallows spaces. - A window-manager WebSocket upgrade that fails for a missing workspace now returns a proper preflight error frame, and the web client refreshes a stale workspace list when it sees that error instead of staying stuck. Migration notes: the release workflow no longer publishes a site changelog receipt commit, and the generator scripts behind it are removed. --- # Changelog v0.3.0-beta.3 Published: 2026-08-01T17:50:50Z ## 0.3.0-beta.3 - 2026-08-01 ### ♻️ Refactoring - Site improvements (#277) ### 🎉 Features - Support grouped skill directories (#270) - Session transcript calm-surface redesign (#271) - Add permission-aware cross-workspace access (#275) - Extensions improvements (#278) - Select and switch runtime per session prompt (#283) - Adopt MCP 2026 and expand the curated catalog (#284) - **BREAKING:** MCP catalogs now require manifest_version 2 and public MCP transport no longer accepts SSE. - Add support for window tabs (#287) ### 🐛 Bug Fixes - Restore Windows daemon support (PR #163 regression + new fixes) (#274) - Untested cases from qa (#276) - Remaining untested qa (#279) - Durable session messaging (#288) ### Release Notes #### Features ##### Grouped skill directories Compozy now discovers `SKILL.md` definitions at any depth below each skill root, so teams can organize capabilities under folders such as `marketing/content/` without changing frontmatter identity or normal precedence. `compozy skill create --group ` now scaffolds grouped workspace skills safely. ##### Unified docs and Marketplace `compozy.com` now serves a single `/docs` experience with reworked navigation, breadcrumbs, responsive layouts, generated CLI reference pages, and API references that include Go examples. A new `/marketplace` section lists skills, extensions, MCP entries, bridge providers, and bundled capabilities with search, install commands, and detail pages. (#277) Migration notes: two CLI verbs were renamed and their old spellings removed — `compozy mcp authorize ` is now `compozy mcp auth login `, and `compozy memory extractor list-pending` is now `compozy memory extractor list-failures`. The `compozy network work status` alias was removed in favor of `compozy network work lookup`, and `compozy network send --body` accepts a kind-specific JSON value rather than requiring an object. ##### Window tabs in the OS shell The OS shell now groups windows into first-class tab frames instead of assuming one window per app. Tabs carry ordered members, an active member, per-tab navigation stacks, pinning, scoped close and reopen, and bounded history. The same topology is exposed through Web, CLI, HTTP, UDS, native tools, streams, hooks, resources, layout profiles, and the bundled Compozy skill, so agents operate windows with the same semantics people see. (#287) - Run multiple instances of the same app, discover their tabs from the dock and the command palette, and drag to group, reorder, or tear out a tab. - Move, swap, and zoom by frame instead of by single window, and adjust Window Manager behavior directly from Settings. - `compozy config set window_manager.*` applies through the canonical Settings section endpoint, so a live apply projects only that section and unrelated restart-required drift stays pending and truthful in `compozy status`. Migration notes: persisted window layouts move to v3 as a hard cut — v2 layout compatibility paths and singleton-window assumptions were removed from the runtime, generated contracts, and layout profiles. #### Fixes ##### Durable session messaging Session prompts no longer duplicate, reorder, or disappear when an optimistic Web message settles, when a client reconnects, or after a cold reload. Every externally authored prompt now carries two durable identities — `message_id` for the rendered message and `idempotency_key` for the command execution — and both survive Web rendering, HTTP/UDS/CLI/native-tool ingress, queueing or steering, ACP dispatch, transcript projection, replay, and reload. (#288) - Retrying the same prompt across supported transports is at-most-once when the original identities are reused: an exact retry returns the original result with `replayed: true` without re-running hooks or the provider. - Divergent reuse of an identity returns a typed conflict, and uncertain post-dispatch recovery is reported as indeterminate instead of silently resending. - Goal retries preserve the original result and the original HTTP status. - Provider-originated ACP `user_message_chunk` echoes no longer appear as a second authored message, while locally authored steer events are preserved. - The CLI, the Extension Host, and `compozy__session_prompt` expose the retry identities. Migration notes: external prompt and steer inputs now require both `message_id` and `idempotency_key`, and Goal prompt responses use the standard wrapped prompt-result envelope. #### Highlights ##### MCP catalog, session runtime, and extension management CompozyOS beta expands how people and agents configure the runtime across MCP, sessions, extensions, workspace boundaries, and the session UI. - Install, authorize, repair, inspect, and remove curated MCP servers through the CLI, HTTP/UDS APIs, Web, and the official Compozy skill. The catalog now uses manifest version 2, the runtime uses the official MCP SDK, and public MCP transport no longer accepts SSE. (#284) - Choose the provider, model, reasoning effort, and speed for each session prompt, switch runtime within a session, and create sessions before their first prompt. (#283) - Create, build, validate, develop, distribute, install, and inspect extensions through the daemon, CLI, APIs, native tools, Web, and SDK contracts. Extension manifests now use version 2. (#278) - Apply existing session permission modes to explicitly targeted cross-workspace agent access, including session-scoped consent where a native-tool prompt is available. (#275) - Read session transcripts through a calmer timeline with clearer tool results, failures, permissions, clarifications, and goal controls. (#271) - Run the daemon on Windows with corrected process locking, SQLite paths, detach behavior, process timestamps, and sync-directory handling. (#274) - Automation jobs can target Loops with workspace inputs and mappings, unresolved tool calls now fail explicitly, and Loop/session recovery paths report clearer state and errors. (#276, #279) Migration notes: update MCP catalog manifests to version 2 and replace public SSE transport; create a session before submitting its first prompt and runtime selection; update extension manifests to version 2. --- # Changelog v0.3.0-beta.2 Published: 2026-07-29T03:25:39Z ## 0.3.0-beta.2 - 2026-07-29 ### ♻️ Refactoring - State management with xstate-store (#268) ### 🎉 Features - Add provider-neutral ACP speed control (#267) ### 🐛 Bug Fixes - Align release and process test contracts - Workspace params (#266) - Onboarding workspace selection --- # Changelog v0.3.0-beta.1 Published: 2026-07-28T13:50:14Z ## 0.3.0-beta.1 - 2026-07-28 ### 🎉 Features - Introducing CompozyOS beta - **BREAKING:** introducing CompozyOS beta ### Release Notes #### Breaking Changes ##### The OS Release Compozy v0.3 is a new operating system boundary for agent work. Sessions, tasks, loops, memory, permissions, automation, the OS shell, and Compozy Network now share one daemon-owned state model. People can start and inspect that work from the web, CLI, HTTP/SSE, or UDS. Agents can operate the same runtime through structured tools and extension contracts. This is a breaking beta. The command, package, environment, storage, API, and tool namespaces move to Compozy, and several v0.2 surfaces have deliberate replacements or removals. Follow the [v0.3 migration guide](https://compozy.com/runtime/migration/) before replacing an existing install. The maintained v0.2 line and its collateral remain on `legacy/v0.2`. Install the beta through the verified hosted installer, `@compozy/cli@beta`, or the explicit `github.com/compozy/compozy@v0.3.0-beta.1` Go version. The beta channel may change before v0.3.0 stable; production rollouts should pin the version and review each prerelease. The repository was already MIT licensed. v0.3 corrects stale BSL-1.1 text in distribution metadata; it does not relicense the code.