# CompozyOS Documentation
> CompozyOS is the system around the agent, already built: it keeps AI agents working continuously, without the scripts, cron jobs, and glue code people otherwise assemble. Loops, triggers, memory, permissions, approvals, and history come built in.
## Current release and migration

- [Migrate from CompozyOS v0.2.15 to CompozyOS v0.3](https://compozy.com/docs/migration): Hard-cut command, configuration, storage, and extension migration guidance.

## Docs

- [How to use these docs](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](https://compozy.com/docs): The system around the agent, already built. What comes built in, and where to start for your job.

## Start here

- [Desktop app](https://compozy.com/docs/getting-started/desktop-app): Start CompozyOS from the desktop, attach to the local runtime, and manage app and runtime updates.
- [Your first custom agent](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](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](https://compozy.com/docs/getting-started/installation): Install the CompozyOS desktop app or the compozy command and prepare the local runtime.
- [Quick Start](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](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.
- [Migrate from v0.2.15](https://compozy.com/docs/migration): Complete command, configuration, extension, SDK, and clean-state migration guide for CompozyOS v0.3.

## Guides & examples

- [Implement-tasks loop](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](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](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](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](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](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](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.
- [Build your first extension](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](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](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](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](https://compozy.com/docs/guides): Goal-oriented guides for running, debugging, and coordinating real CompozyOS work without reading the full reference first.
- [Handoff between agents](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](https://compozy.com/docs/use-cases): Outcome-oriented CompozyOS operating paths for code review, release readiness, and agent handoff.
- [Prepare a project workspace](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](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](https://compozy.com/docs/use-cases/review-a-change): Use a CompozyOS session to inspect a code change and return durable review evidence.

## Core concepts

- [Agent Capabilities](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](https://compozy.com/docs/agents/definitions): The current AGENT.md format, discovery order, runtime defaults, and parser edge cases used by CompozyOS.
- [Agent Heartbeat](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](https://compozy.com/docs/agents): How CompozyOS resolves agent definitions, advertises capabilities, launches providers, and supervises ACP subprocesses.
- [Provider Model Catalog](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](https://compozy.com/docs/agents/providers): Built-in provider IDs, launch commands, config overrides, and custom provider setup for CompozyOS agents.
- [Agent Soul](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](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.
- [Task-Run Coordination Conversations](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](https://compozy.com/docs/autonomy/coordinator): When CompozyOS starts a workspace coordinator and why coordinator bootstrap is independent from Network participation.
- [Task Execution Profiles](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](https://compozy.com/docs/autonomy): Explicit operator control, coordinator handoff, task leases, optional Live coordination conversations, and safe spawn.
- [Notification Cursors](https://compozy.com/docs/autonomy/notification-cursors): Bridge terminal task notifications, durable cursor diagnostics, replay semantics, and SSE reconnect seeding.
- [Notification Presets](https://compozy.com/docs/autonomy/notification-presets): SQLite-backed notification fanout presets, cursor replay, filters, and bridge suppression.
- [Review Gate](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](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](https://compozy.com/docs/autonomy/task-runs-and-leases): How agents claim work, renew leases, finish runs, and release session-bound ownership safely.
- [Memory Best Practices](https://compozy.com/docs/memory/best-practices): Practical rules for writing useful CompozyOS memories, keeping indexes readable, and avoiding context bloat.
- [Dream](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](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](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](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.
- [Daytona Sandbox Provider](https://compozy.com/docs/sandbox/daytona): Configure and operate the implemented Daytona sandbox backend.
- [Sandbox](https://compozy.com/docs/sandbox): How CompozyOS runs sessions on the host or inside provider-backed sandboxes.
- [Sandbox Profiles](https://compozy.com/docs/sandbox/profiles): Configure sandbox profiles, defaults, workspace selection, and safe-spawn grants.
- [Workspace Config Overlays](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](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](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](https://compozy.com/docs/workspaces/resolver): How CompozyOS registers workspace roots, resolves the active workspace, and discovers project-local runtime resources.
- [Window Management](https://compozy.com/docs/workspaces/window-management): Persistent virtual desktops, semantic window placement, revision-safe layouts, connected clients, and recovery.
- [Event Streaming](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](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](https://compozy.com/docs/sessions): The durable runtime unit CompozyOS creates, attaches, audits, and governs.
- [Session lifecycle](https://compozy.com/docs/sessions/lifecycle): How CompozyOS creates, activates, stops, and classifies one durable runtime session.
- [Session Orchestration](https://compozy.com/docs/sessions/orchestration): Wait for session state and coordinate governed child sessions through CLI, HTTP, UDS, and native tools.
- [Permissions](https://compozy.com/docs/sessions/permissions): How CompozyOS applies static permission modes, workspace boundaries, and interactive approvals during session execution.
- [Resume Attach and Replay](https://compozy.com/docs/sessions/resume): How CompozyOS attaches operators to resumable sessions, reconstructs transcripts from events, and returns deterministic recaps.
- [Agent Management Surface](https://compozy.com/docs/worktrees/agent-surface): Operate Worktrees through structured CLI, HTTP, UDS, native tools, events, hooks, and stable error codes.
- [Assisted Exit](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](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](https://compozy.com/docs/worktrees/create-and-adopt): Create a managed linked checkout, follow its setup phases, or adopt an existing Git worktree.
- [Worktrees](https://compozy.com/docs/worktrees): Run sessions, tasks, and Loops in isolated Git checkouts while sharing the parent workspace's runtime context.
- [Loop Environments](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](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](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](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.
- [Worktree Model](https://compozy.com/docs/worktrees/concepts): The ownership, identity, Git-truth, binding, and concurrency rules behind CompozyOS Worktrees.

## Automation

- [Automation](https://compozy.com/docs/automation): Run CompozyOS agents on schedules, in response to runtime events, or from signed external HTTP requests.
- [Jobs and Scheduling](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](https://compozy.com/docs/automation/suggestions): Review workspace-scoped Job proposals, create the useful ones, and durably dismiss the rest.
- [Triggers](https://compozy.com/docs/automation/triggers): Configure CompozyOS automation triggers that react to runtime events, filters, and prompt templates.
- [Webhooks](https://compozy.com/docs/automation/webhooks): Set up signed CompozyOS webhook triggers for CI, deployment, and external event integrations.
- [Control Bridge Access](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](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](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](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](https://compozy.com/docs/bridges): How CompozyOS bridge instances connect workspace agents to external messaging platforms.
- [Bridge Operations](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](https://compozy.com/docs/bridges/progress): Configure daemon-rendered tool progress for bridge-delivered agent turns.
- [Bridge Routing](https://compozy.com/docs/bridges/routing): How bridge routing policies map platform messages to CompozyOS sessions and delivery targets.
- [Discord Setup](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](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](https://compozy.com/docs/bridges/setup-github): Connect one repository's issue and review comments through PAT or GitHub App authentication.
- [Linear Setup](https://compozy.com/docs/bridges/setup-linear): Connect Linear comments or Agent Sessions with API-key or OAuth client-credentials authentication.
- [Slack Setup](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](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](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](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](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.
- [Authoring loop](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](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](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](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](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](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](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](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](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](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](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](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](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](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](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](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.

## Compozy Network

- [Participation, Channels, and Peers](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](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](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](https://compozy.com/docs/network): How Local and Live participation control Compozy Network state, tools, conversations, wakes, and usage.
- [Protocol Model](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](https://compozy.com/docs/network/task-promotion): Promote a Network thread into durable task intent without granting peers task mutation authority.
- [Public Threads](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](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.
- [Capability Discovery](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](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](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)](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](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](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](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](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](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](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](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](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)](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.
- [Implementation Guide](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](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](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)](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.

## Extensibility

- [Agent Plugins Interoperability](https://compozy.com/docs/extensions/agent-plugins): How CompozyOS detects, validates, and maps Agent Plugins packages into the extension lifecycle.
- [Extension Commands](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](https://compozy.com/docs/extensions/develop): The authoring loop for code-backed and resource-only CompozyOS extensions — build, validate, dev, reload, logs, and publish.
- [Extensions](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](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](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](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](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](https://compozy.com/docs/extensions/secrets): Bind declared extension environment names to instance-scoped Vault refs without exposing secret values.
- [Hook Declaration Format](https://compozy.com/docs/hooks/declaration): Reference for declaring CompozyOS hooks, matchers, subprocess executors, ordering, and runtime execution behavior.
- [Hook Event Catalog](https://compozy.com/docs/hooks/event-catalog): Complete reference for CompozyOS hook events, payload schemas, patch schemas, sync eligibility, and example payloads.
- [Hooks](https://compozy.com/docs/hooks): Intercept named runtime events, inspect the payload, and emit a JSON patch that CompozyOS applies in a deterministic order.
- [Marketplace](https://compozy.com/docs/marketplace): Discover, inspect, install, authorize, update, and manage skills, extensions, and MCP servers through one catalog.
- [Curated MCP catalog](https://compozy.com/docs/marketplace/mcp-catalog): Reference for the MCP servers CompozyOS curates, their safe defaults, and deliberate omissions.
- [Desired-State Resources](https://compozy.com/docs/resources): How CompozyOS stores extensible runtime resources, validates mutations, and reconciles projected runtime state.
- [Bundled Skill](https://compozy.com/docs/skills/bundled): The CompozyOS skill compiled into the runtime, its reference files, and how contextual loading works.
- [Skills Overview](https://compozy.com/docs/skills): How CompozyOS discovers skills, resolves precedence, injects the prompt catalog, and connects skills to MCP servers.
- [Skills Marketplace](https://compozy.com/docs/skills/marketplace): How to discover, install, update, and remove marketplace skills with CompozyOS.
- [SKILL.md Format](https://compozy.com/docs/skills/skill-md): The accepted SKILL.md frontmatter schema, Markdown body rules, MCP sidecars, hooks, and complete examples.
- [Tool Registry](https://compozy.com/docs/tools): How CompozyOS exposes daemon-owned tools to operators and managed agents through one policy-checked registry.
- [Policy and Invocation](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](https://compozy.com/docs/tools/result-artifacts): Open, page, and retain exact tool results that exceed the active result budget.
- [Toolsets](https://compozy.com/docs/tools/toolsets): How CompozyOS groups registry tools into named exposure sets for discovery, policy, and session startup.

## Operations

- [AGENT.md](https://compozy.com/docs/configuration/agent-md): Complete implemented AGENT.md schema, parser rules, provider examples, MCP sidecars, and RFC drift.
- [config.toml](https://compozy.com/docs/configuration/config-toml): Complete CompozyOS config.toml schema, defaults, valid values, merge behavior, and annotated examples.
- [Environment Variables](https://compozy.com/docs/configuration/env-vars): Environment variables CompozyOS reads, injects, propagates, and explicitly does not support.
- [File Locations](https://compozy.com/docs/configuration/file-locations): All CompozyOS global, workspace, agent, skill, database, log, socket, memory, and extension paths.
- [Configuration Overview](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](https://compozy.com/docs/configuration/lifecycle-matrix): Generated CompozyOS config lifecycle matrix for live apply, session rebind, and restart-required changes.
- [mcp.json](https://compozy.com/docs/configuration/mcp-json): Configure, authorize, inspect, edit, and repair local and remote MCP servers across CompozyOS scopes.
- [Keyboard shortcuts](https://compozy.com/docs/configuration/shortcuts): Configure the live CompozyOS keymap, inspect effective bindings, and apply the Terminal preset.
- [SKILL.md](https://compozy.com/docs/configuration/skill-md): Complete implemented SKILL.md schema, CompozyOS metadata, sidecar files, hook declarations, and body conventions.
- [Vault](https://compozy.com/docs/configuration/vault): Store CompozyOS-managed encrypted secrets with redacted CLI, HTTP, UDS, web, and session-scoped metadata surfaces.
- [Gateway](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](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](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](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](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](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](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.
- [Daemon Operations](https://compozy.com/docs/operations/daemon): Start, stop, restart, inspect, and supervise the CompozyOS daemon.
- [Database Operations](https://compozy.com/docs/operations/database): Back up, inspect, and clean up CompozyOS's SQLite databases.
- [Desktop app operations](https://compozy.com/docs/operations/desktop-app): Diagnose Electron launch failures and recover app or runtime updates without changing runtime data.
- [Desktop release operations](https://compozy.com/docs/operations/desktop-release): Publish or repair the beta Electron channel through verified GitHub release assets and an audited branch update.
- [Operations](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](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](https://compozy.com/docs/operations/production): Prepare CompozyOS for persistent unattended operation with clear pass and fail checks.
- [Support Bundles](https://compozy.com/docs/operations/support-bundles): Create redacted, daemon-owned support bundles for incident response and maintainer triage.
- [Troubleshooting](https://compozy.com/docs/operations/troubleshooting): Diagnose and resolve common CompozyOS daemon, socket, agent, session, and database issues.

## Reference

- [Agent](https://compozy.com/docs/api/agent): CompozyOS Agent HTTP endpoints.
- [Agents](https://compozy.com/docs/api/agents): CompozyOS Agents HTTP endpoints.
- [Automation](https://compozy.com/docs/api/automation): CompozyOS Automation HTTP endpoints.
- [Bridges](https://compozy.com/docs/api/bridges): CompozyOS Bridges HTTP endpoints.
- [Diagnostics](https://compozy.com/docs/api/diagnostics): CompozyOS Diagnostics HTTP endpoints.
- [Extensions](https://compozy.com/docs/api/extensions): CompozyOS Extensions HTTP endpoints.
- [Filesystem](https://compozy.com/docs/api/filesystem): CompozyOS Filesystem HTTP endpoints.
- [Gateway](https://compozy.com/docs/api/gateway): CompozyOS Gateway HTTP endpoints.
- [Hooks](https://compozy.com/docs/api/hooks): CompozyOS Hooks HTTP endpoints.
- [API Reference](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](https://compozy.com/docs/api/logs): CompozyOS Logs HTTP endpoints.
- [Loops](https://compozy.com/docs/api/loops): CompozyOS Loops HTTP endpoints.
- [Marketplace](https://compozy.com/docs/api/marketplace): CompozyOS Marketplace HTTP endpoints.
- [Memory](https://compozy.com/docs/api/memory): CompozyOS Memory HTTP endpoints.
- [Network](https://compozy.com/docs/api/network): CompozyOS Network HTTP endpoints.
- [Notifications](https://compozy.com/docs/api/notifications): CompozyOS Notifications HTTP endpoints.
- [Observe](https://compozy.com/docs/api/observe): CompozyOS Observe HTTP endpoints.
- [Onboarding](https://compozy.com/docs/api/onboarding): CompozyOS Onboarding HTTP endpoints.
- [Openai](https://compozy.com/docs/api/openai): CompozyOS Openai HTTP endpoints.
- [Providers](https://compozy.com/docs/api/providers): CompozyOS Providers HTTP endpoints.
- [Resources](https://compozy.com/docs/api/resources): CompozyOS Resources HTTP endpoints.
- [Roles](https://compozy.com/docs/api/roles): CompozyOS Roles HTTP endpoints.
- [Sessions](https://compozy.com/docs/api/sessions): CompozyOS Sessions HTTP endpoints.
- [Settings](https://compozy.com/docs/api/settings): CompozyOS Settings HTTP endpoints.
- [Skills](https://compozy.com/docs/api/skills): CompozyOS Skills HTTP endpoints.
- [Support](https://compozy.com/docs/api/support): CompozyOS Support HTTP endpoints.
- [Tasks](https://compozy.com/docs/api/tasks): CompozyOS Tasks HTTP endpoints.
- [Tools](https://compozy.com/docs/api/tools): CompozyOS Tools HTTP endpoints.
- [Toolsets](https://compozy.com/docs/api/toolsets): CompozyOS Toolsets HTTP endpoints.
- [Vault](https://compozy.com/docs/api/vault): CompozyOS Vault HTTP endpoints.
- [Workspaces](https://compozy.com/docs/api/workspaces): CompozyOS Workspaces HTTP endpoints.
- [Worktrees](https://compozy.com/docs/api/worktrees): CompozyOS Worktrees HTTP endpoints.
- [compozy](https://compozy.com/docs/cli/compozy): CompozyOS — the system around your agents, already built
- [compozy doctor](https://compozy.com/docs/cli/doctor): Run runtime diagnostics
- [compozy drain](https://compozy.com/docs/cli/drain): Stop admitting new work while in-flight work completes
- [CLI Reference](https://compozy.com/docs/cli): Generated command reference and cross-cutting behavior for the CompozyOS CLI.
- [compozy install](https://compozy.com/docs/cli/install): Bootstrap CompozyOS and create the default general agent
- [compozy logs](https://compozy.com/docs/cli/logs): Read cross-session runtime logs
- [compozy notify](https://compozy.com/docs/cli/notify): Send the operator a notification
- [compozy open](https://compozy.com/docs/cli/open): Open the CompozyOS web UI in the default browser
- [compozy spawn](https://compozy.com/docs/cli/spawn): Spawn a bounded child agent session
- [compozy status](https://compozy.com/docs/cli/status): Show consolidated runtime status
- [compozy undrain](https://compozy.com/docs/cli/undrain): Resume admission of new work
- [compozy uninstall](https://compozy.com/docs/cli/uninstall): Stop CompozyOS and remove runtime launch artifacts
- [compozy update](https://compozy.com/docs/cli/update): Check for and apply CompozyOS runtime and app updates
- [compozy version](https://compozy.com/docs/cli/version): Print the CompozyOS version
- [compozy whoami](https://compozy.com/docs/cli/whoami): Print the current CompozyOS agent identity from environment variables
- [compozy agent create](https://compozy.com/docs/cli/agent/create): Create a global or workspace-local agent definition
- [compozy agent delete](https://compozy.com/docs/cli/agent/delete): Durably delete an agent definition
- [compozy agent duplicate](https://compozy.com/docs/cli/agent/duplicate): Duplicate an agent definition without exposing secrets
- [compozy agent](https://compozy.com/docs/cli/agent): Inspect CompozyOS agent definitions
- [compozy agent info](https://compozy.com/docs/cli/agent/info): Show one agent definition
- [compozy agent list](https://compozy.com/docs/cli/agent/list): List installed agent definitions
- [compozy agent update](https://compozy.com/docs/cli/agent/update): Update an agent definition for future sessions
- [compozy app diagnose](https://compozy.com/docs/cli/app/diagnose): Show safe desktop diagnostics
- [compozy app](https://compozy.com/docs/cli/app): Manage the CompozyOS desktop app
- [compozy app open](https://compozy.com/docs/cli/app/open): Launch or focus the desktop app
- [compozy app retry](https://compozy.com/docs/cli/app/retry): Retry the current desktop app operation
- [compozy app status](https://compozy.com/docs/cli/app/status): Show desktop app status
- [compozy automation](https://compozy.com/docs/cli/automation): Manage automation jobs, triggers, suggestions, and runs
- [compozy bridge create](https://compozy.com/docs/cli/bridge/create): Create a bridge instance
- [compozy bridge disable](https://compozy.com/docs/cli/bridge/disable): Disable a bridge instance
- [compozy bridge enable](https://compozy.com/docs/cli/bridge/enable): Enable a bridge instance
- [compozy bridge get](https://compozy.com/docs/cli/bridge/get): Show one bridge instance
- [compozy bridge](https://compozy.com/docs/cli/bridge): Manage bridge instances
- [compozy bridge list](https://compozy.com/docs/cli/bridge/list): List bridge instances
- [compozy bridge resolve](https://compozy.com/docs/cli/bridge/resolve): Resolve a bridge target name without sending
- [compozy bridge restart](https://compozy.com/docs/cli/bridge/restart): Restart a bridge instance
- [compozy bridge routes](https://compozy.com/docs/cli/bridge/routes): Inspect routes for one bridge instance
- [compozy bridge send-test](https://compozy.com/docs/cli/bridge/send-test): Send one real message through a bridge provider
- [compozy bridge targets](https://compozy.com/docs/cli/bridge/targets): List discovered targets for one bridge instance
- [compozy bridge test-delivery](https://compozy.com/docs/cli/bridge/test-delivery): Resolve a typed outbound delivery target for one bridge instance
- [compozy bridge update](https://compozy.com/docs/cli/bridge/update): Update mutable bridge fields
- [compozy bridge verify](https://compozy.com/docs/cli/bridge/verify): Run live provider checks for one bridge instance
- [compozy ch](https://compozy.com/docs/cli/ch): Use agent-facing coordination channels
- [compozy ch list](https://compozy.com/docs/cli/ch/list): List coordination channels visible to the current agent session
- [compozy ch recv](https://compozy.com/docs/cli/ch/recv): Receive queued coordination messages for a channel
- [compozy ch reply](https://compozy.com/docs/cli/ch/reply): Reply to a received coordination message
- [compozy ch send](https://compozy.com/docs/cli/ch/send): Send one task-run coordination message
- [compozy completion bash](https://compozy.com/docs/cli/completion/bash): Generate the autocompletion script for bash
- [compozy completion fish](https://compozy.com/docs/cli/completion/fish): Generate the autocompletion script for fish
- [compozy completion](https://compozy.com/docs/cli/completion): Generate the autocompletion script for the specified shell
- [compozy completion powershell](https://compozy.com/docs/cli/completion/powershell): Generate the autocompletion script for powershell
- [compozy completion zsh](https://compozy.com/docs/cli/completion/zsh): Generate the autocompletion script for zsh
- [compozy config apply-history](https://compozy.com/docs/cli/config/apply-history): List persisted config apply records
- [compozy config check](https://compozy.com/docs/cli/config/check): Alias for config validate
- [compozy config edit](https://compozy.com/docs/cli/config/edit): Open the selected config overlay in $VISUAL or $EDITOR
- [compozy config get](https://compozy.com/docs/cli/config/get): Get one redacted effective config value
- [compozy config](https://compozy.com/docs/cli/config): Inspect and mutate CompozyOS configuration
- [compozy config list](https://compozy.com/docs/cli/config/list): List redacted effective config values
- [compozy config path](https://compozy.com/docs/cli/config/path): Show resolved CompozyOS config paths
- [compozy config reload](https://compozy.com/docs/cli/config/reload): Reconcile config.toml with the daemon active generation
- [compozy config set](https://compozy.com/docs/cli/config/set): Set one config value through the validated config writer
- [compozy config show](https://compozy.com/docs/cli/config/show): Show the redacted effective config
- [compozy config unset](https://compozy.com/docs/cli/config/unset): Remove one config value through the validated config writer
- [compozy config validate](https://compozy.com/docs/cli/config/validate): Validate CompozyOS configuration
- [compozy connect add](https://compozy.com/docs/cli/connect/add): Add a paired HTTPS connection profile
- [compozy connect export](https://compozy.com/docs/cli/connect/export): Export a portable encrypted HTTPS profile
- [compozy connect import](https://compozy.com/docs/cli/connect/import): Import a portable encrypted HTTPS profile
- [compozy connect](https://compozy.com/docs/cli/connect): Manage CLI connection profiles
- [compozy connect list](https://compozy.com/docs/cli/connect/list): List connection profiles without reading credentials
- [compozy connect remove](https://compozy.com/docs/cli/connect/remove): Remove profile metadata and its client-local credential
- [compozy connect ssh](https://compozy.com/docs/cli/connect/ssh): Reach a remote daemon through a loopback-only SSH forward
- [compozy connect use](https://compozy.com/docs/cli/connect/use): Choose the default CLI target
- [compozy daemon bootstrap](https://compozy.com/docs/cli/daemon/bootstrap): Resolve, provision, and start the desktop runtime
- [compozy daemon](https://compozy.com/docs/cli/daemon): Manage the CompozyOS daemon
- [compozy daemon start](https://compozy.com/docs/cli/daemon/start): Start the CompozyOS daemon
- [compozy daemon stop](https://compozy.com/docs/cli/daemon/stop): Stop the CompozyOS daemon
- [compozy desktop create](https://compozy.com/docs/cli/desktop/create): Create a persistent virtual desktop
- [compozy desktop delete](https://compozy.com/docs/cli/desktop/delete): Delete a desktop with an explicit transfer destination when needed
- [compozy desktop](https://compozy.com/docs/cli/desktop): Manage virtual desktops in a workspace
- [compozy desktop list](https://compozy.com/docs/cli/desktop/list): List persistent virtual desktops
- [compozy desktop reorder](https://compozy.com/docs/cli/desktop/reorder): Move a desktop to an ordered position
- [compozy desktop switch](https://compozy.com/docs/cli/desktop/switch): Switch one connected client to a desktop
- [compozy desktop update](https://compozy.com/docs/cli/desktop/update): Rename a virtual desktop
- [compozy device](https://compozy.com/docs/cli/device): Manage paired gateway devices
- [compozy device list](https://compozy.com/docs/cli/device/list): List paired devices
- [compozy device rename](https://compozy.com/docs/cli/device/rename): Rename a paired device
- [compozy device revoke](https://compozy.com/docs/cli/device/revoke): Revoke a paired device and close its live streams
- [compozy gateway audit](https://compozy.com/docs/cli/gateway/audit): Audit gateway security posture
- [compozy gateway](https://compozy.com/docs/cli/gateway): Manage remote gateway exposure
- [compozy gateway status](https://compozy.com/docs/cli/gateway/status): Show gateway exposure and device state
- [compozy extension build](https://compozy.com/docs/cli/extension/build): Build source into an immutable extension bundle
- [compozy extension commands](https://compozy.com/docs/cli/extension/commands): List active extension-contributed commands
- [compozy extension dev](https://compozy.com/docs/cli/extension/dev): Build and link an extension to the current workspace
- [compozy extension disable](https://compozy.com/docs/cli/extension/disable): Disable an installed extension
- [compozy extension enable](https://compozy.com/docs/cli/extension/enable): Enable an installed extension
- [compozy extension exec](https://compozy.com/docs/cli/extension/exec): Invoke an extension command through daemon tool policy
- [compozy extension](https://compozy.com/docs/cli/extension): Manage CompozyOS extensions
- [compozy extension init](https://compozy.com/docs/cli/extension/init): Create an extension project from an embedded template
- [compozy extension install](https://compozy.com/docs/cli/extension/install): Install an extension from curated, GitHub, git, or a local path
- [compozy extension inventory](https://compozy.com/docs/cli/extension/inventory): Show shipped and live resources for an extension
- [compozy extension list](https://compozy.com/docs/cli/extension/list): List installed extensions
- [compozy extension logs](https://compozy.com/docs/cli/extension/logs): Read redacted logs for one extension instance
- [compozy extension preview](https://compozy.com/docs/cli/extension/preview): Preview enabling an extension without changing state
- [compozy extension provenance](https://compozy.com/docs/cli/extension/provenance): Show extension provenance and trust report
- [compozy extension publish](https://compozy.com/docs/cli/extension/publish): Publish an immutable extension generation to GitHub Releases
- [compozy extension reload](https://compozy.com/docs/cli/extension/reload): Build and atomically reload a dev-linked extension
- [compozy extension remove](https://compozy.com/docs/cli/extension/remove): Remove an installed extension from disk and the registry
- [compozy extension search](https://compozy.com/docs/cli/extension/search): Search curated and GitHub extensions
- [compozy extension status](https://compozy.com/docs/cli/extension/status): Show extension runtime status
- [compozy extension update](https://compozy.com/docs/cli/extension/update): Check for or install extension updates
- [compozy extension validate](https://compozy.com/docs/cli/extension/validate): Validate an extension bundle without running its code
- [compozy hooks events](https://compozy.com/docs/cli/hooks/events): List supported hook events
- [compozy hooks](https://compozy.com/docs/cli/hooks): Inspect configured and executed hooks
- [compozy hooks info](https://compozy.com/docs/cli/hooks/info): Show detailed information for one or more hooks by name
- [compozy hooks list](https://compozy.com/docs/cli/hooks/list): List resolved hooks in pipeline order
- [compozy hooks runs](https://compozy.com/docs/cli/hooks/runs): Show persisted hook execution history
- [compozy layout apply](https://compozy.com/docs/cli/layout/apply): Atomically replace topology from a validated layout document
- [compozy layout arrange](https://compozy.com/docs/cli/layout/arrange): Arrange explicit windows or apply a declarative layout resource
- [compozy layout balance](https://compozy.com/docs/cli/layout/balance): Equalize one split or every split in a group
- [compozy layout export](https://compozy.com/docs/cli/layout/export): Export a history-free declarative layout document
- [compozy layout frame-resize](https://compozy.com/docs/cli/layout/frame-resize): Atomically rewrite island frames to move a shared tiled boundary
- [compozy layout get](https://compozy.com/docs/cli/layout/get): Get the authoritative topology and revision
- [compozy layout](https://compozy.com/docs/cli/layout): Inspect, preview, and change workspace layouts
- [compozy layout preview](https://compozy.com/docs/cli/layout/preview): Preview any semantic window-manager command without writing
- [compozy layout redo](https://compozy.com/docs/cli/layout/redo): Redo the latest undone layout operation
- [compozy layout resize](https://compozy.com/docs/cli/layout/resize): Resize one shared split boundary
- [compozy layout undo](https://compozy.com/docs/cli/layout/undo): Undo the latest workspace layout operation
- [compozy layout validate](https://compozy.com/docs/cli/layout/validate): Validate a declarative layout without writing it
- [compozy layout watch](https://compozy.com/docs/cli/layout/watch): Watch topology events and optional client presentation frames
- [compozy layout-profile delete](https://compozy.com/docs/cli/layout-profile/delete): Delete one saved layout
- [compozy layout-profile get](https://compozy.com/docs/cli/layout-profile/get): Get one saved layout
- [compozy layout-profile](https://compozy.com/docs/cli/layout-profile): List, read, save, and delete saved layouts
- [compozy layout-profile list](https://compozy.com/docs/cli/layout-profile/list): List saved layouts visible to a workspace, global scope included
- [compozy layout-profile put](https://compozy.com/docs/cli/layout-profile/put): Create or replace one saved layout
- [compozy loop approve](https://compozy.com/docs/cli/loop/approve): Apply one Loop human-gate decision
- [compozy loop cancel](https://compozy.com/docs/cli/loop/cancel): Cancel one Loop run
- [compozy loop configure](https://compozy.com/docs/cli/loop/configure): Write per-loop runtime config overrides
- [compozy loop create](https://compozy.com/docs/cli/loop/create): Create, fork, or publish one Loop definition
- [compozy loop delete](https://compozy.com/docs/cli/loop/delete): Delete one user-authored Loop definition
- [compozy loop edit](https://compozy.com/docs/cli/loop/edit): Edit and publish one Loop definition with $EDITOR
- [compozy loop](https://compozy.com/docs/cli/loop): Manage Loop definitions and runs
- [compozy loop inspect](https://compozy.com/docs/cli/loop/inspect): Inspect one Loop definition
- [compozy loop kill](https://compozy.com/docs/cli/loop/kill): Kill one Loop run
- [compozy loop list](https://compozy.com/docs/cli/loop/list): List Loop definitions
- [compozy loop nodes](https://compozy.com/docs/cli/loop/nodes): List workspace Loop node state
- [compozy loop pause](https://compozy.com/docs/cli/loop/pause): Pause one Loop run
- [compozy loop resume](https://compozy.com/docs/cli/loop/resume): Resume one Loop run
- [compozy loop run](https://compozy.com/docs/cli/loop/run): Start or dry-run one Loop
- [compozy loop runs](https://compozy.com/docs/cli/loop/runs): List workspace Loop runs
- [compozy loop status](https://compozy.com/docs/cli/loop/status): Inspect one Loop run
- [compozy loop turns](https://compozy.com/docs/cli/loop/turns): List one Loop run's Goal turn audit
- [compozy loop validate](https://compozy.com/docs/cli/loop/validate): Validate one Loop definition without saving
- [compozy marketplace](https://compozy.com/docs/cli/marketplace): Discover installable CompozyOS capabilities
- [compozy marketplace info](https://compozy.com/docs/cli/marketplace/info): Show one marketplace entry
- [compozy marketplace refresh](https://compozy.com/docs/cli/marketplace/refresh): Refresh curated marketplace catalogs
- [compozy marketplace search](https://compozy.com/docs/cli/marketplace/search): Search or browse the marketplace
- [compozy mcp](https://compozy.com/docs/cli/mcp): Manage MCP integrations
- [compozy mcp install](https://compozy.com/docs/cli/mcp/install): Install a curated MCP server
- [compozy mcp serve](https://compozy.com/docs/cli/mcp/serve): Serve the workspace-bound CompozyOS Host API over MCP
- [compozy me context](https://compozy.com/docs/cli/me/context): Inspect the bounded situation context for the current agent session
- [compozy me](https://compozy.com/docs/cli/me): Inspect the current CompozyOS-managed agent session
- [compozy memory delete](https://compozy.com/docs/cli/memory/delete): Delete a Memory v2 entry through the controller
- [compozy memory edit](https://compozy.com/docs/cli/memory/edit): Edit a Memory v2 entry through the controller
- [compozy memory health](https://compozy.com/docs/cli/memory/health): Show Memory v2 health
- [compozy memory history](https://compozy.com/docs/cli/memory/history): Show redaction-safe Memory v2 operation history
- [compozy memory](https://compozy.com/docs/cli/memory): Show, write, search, and operate Memory v2 durable context
- [compozy memory list](https://compozy.com/docs/cli/memory/list): List Memory v2 entries
- [compozy memory promote](https://compozy.com/docs/cli/memory/promote): Promote a memory entry across Memory v2 scopes
- [compozy memory reindex](https://compozy.com/docs/cli/memory/reindex): Rebuild the derived Memory v2 search catalog
- [compozy memory reload](https://compozy.com/docs/cli/memory/reload): Invalidate frozen memory snapshots for future session boots
- [compozy memory reset](https://compozy.com/docs/cli/memory/reset): Reset derived Memory v2 state through the daemon
- [compozy memory scope-show](https://compozy.com/docs/cli/memory/scope-show): Show resolved Memory v2 precedence for a selector
- [compozy memory search](https://compozy.com/docs/cli/memory/search): Search deterministic Memory v2 recall
- [compozy memory show](https://compozy.com/docs/cli/memory/show): Show one Memory v2 entry
- [compozy memory write](https://compozy.com/docs/cli/memory/write): Create a Memory v2 entry through the controller
- [compozy network inbox](https://compozy.com/docs/cli/network/inbox): Show queued inbound messages for one session
- [compozy network](https://compozy.com/docs/cli/network): Operate the daemon-owned network runtime
- [compozy network mute](https://compozy.com/docs/cli/network/mute): Mute one peer's network delivery
- [compozy network peers](https://compozy.com/docs/cli/network/peers): List visible local peers and their capability cards
- [compozy network send](https://compozy.com/docs/cli/network/send): Send one envelope through the daemon-owned network runtime
- [compozy network status](https://compozy.com/docs/cli/network/status): Show Network availability, Live participation, and runtime metrics
- [compozy network subscribe](https://compozy.com/docs/cli/network/subscribe): Subscribe one peer to full delivery
- [compozy network unmute](https://compozy.com/docs/cli/network/unmute): Remove one network delivery preference
- [compozy network usage](https://compozy.com/docs/cli/network/usage): Show workspace-scoped network wake usage from the ledger
- [compozy notifications](https://compozy.com/docs/cli/notifications): Manage notification presets
- [compozy observe](https://compozy.com/docs/cli/observe): Inspect runtime observability read models
- [compozy observe overview](https://compozy.com/docs/cli/observe/overview): Show the home overview: what agents did, what needs you, what it costs
- [compozy onboarding complete](https://compozy.com/docs/cli/onboarding/complete): Mark first-run onboarding as completed
- [compozy onboarding](https://compozy.com/docs/cli/onboarding): Inspect and manage first-run onboarding state
- [compozy onboarding reset](https://compozy.com/docs/cli/onboarding/reset): Clear the onboarding completion flag so the wizard runs again
- [compozy onboarding status](https://compozy.com/docs/cli/onboarding/status): Show whether first-run onboarding has been completed
- [compozy provider](https://compozy.com/docs/cli/provider): Inspect and manage provider authentication
- [compozy provider list](https://compozy.com/docs/cli/provider/list): List providers and declared auth state
- [compozy pair](https://compozy.com/docs/cli/pair): Pair remote clients with a gateway
- [compozy pair mint](https://compozy.com/docs/cli/pair/mint): Mint a short-lived pairing artifact into a private handoff file
- [compozy pair redeem](https://compozy.com/docs/cli/pair/redeem): Redeem a pairing artifact into a named remote profile
- [compozy resource delete](https://compozy.com/docs/cli/resource/delete): Delete one desired-state resource
- [compozy resource get](https://compozy.com/docs/cli/resource/get): Show one desired-state resource
- [compozy resource](https://compozy.com/docs/cli/resource): Manage desired-state resources
- [compozy resource list](https://compozy.com/docs/cli/resource/list): List desired-state resources
- [compozy resource put](https://compozy.com/docs/cli/resource/put): Create or update one desired-state resource
- [compozy roles](https://compozy.com/docs/cli/roles): Inspect effective background role configuration
- [compozy roles list](https://compozy.com/docs/cli/roles/list): List effective background roles
- [compozy roles show](https://compozy.com/docs/cli/roles/show): Show one effective background role
- [compozy session approve](https://compozy.com/docs/cli/session/approve): Approve or reject a pending session permission request
- [compozy session archive](https://compozy.com/docs/cli/session/archive): Archive a stopped session
- [compozy session commands](https://compozy.com/docs/cli/session/commands): List commands available to a session
- [compozy session events](https://compozy.com/docs/cli/session/events): Read session events
- [compozy session health](https://compozy.com/docs/cli/session/health): Read session health and wake eligibility
- [compozy session history](https://compozy.com/docs/cli/session/history): Show session history grouped by turn
- [compozy session](https://compozy.com/docs/cli/session): Manage CompozyOS sessions
- [compozy session inspect](https://compozy.com/docs/cli/session/inspect): Inspect session health, wake audit, and policy correlation
- [compozy session interactions](https://compozy.com/docs/cli/session/interactions): List pending session questions and permission requests
- [compozy session list](https://compozy.com/docs/cli/session/list): List sessions
- [compozy session new](https://compozy.com/docs/cli/session/new): Create a new session
- [compozy session prompt-cancel](https://compozy.com/docs/cli/session/prompt-cancel): Cancel the active session prompt
- [compozy session prompt](https://compozy.com/docs/cli/session/prompt): Send a prompt to a session
- [compozy session recap](https://compozy.com/docs/cli/session/recap): Show deterministic session recap
- [compozy session remove](https://compozy.com/docs/cli/session/remove): Remove a session and its persisted history
- [compozy session rename](https://compozy.com/docs/cli/session/rename): Rename a user session
- [compozy session repair](https://compozy.com/docs/cli/session/repair): Inspect and repair an interrupted session transcript
- [compozy session resume](https://compozy.com/docs/cli/session/resume): Attach to a resumable session
- [compozy session rewind](https://compozy.com/docs/cli/session/rewind): Rewind a session before a user message
- [compozy session status](https://compozy.com/docs/cli/session/status): Show session status
- [compozy session stop](https://compozy.com/docs/cli/session/stop): Stop a session
- [compozy session unarchive](https://compozy.com/docs/cli/session/unarchive): Restore an archived session
- [compozy session usage](https://compozy.com/docs/cli/session/usage): Show aggregated session token usage and cost provenance
- [compozy session wait](https://compozy.com/docs/cli/session/wait): Wait for a session state
- [compozy skill create](https://compozy.com/docs/cli/skill/create): Scaffold a new workspace skill
- [compozy skill disable](https://compozy.com/docs/cli/skill/disable): Disable a daemon-managed skill
- [compozy skill enable](https://compozy.com/docs/cli/skill/enable): Enable a daemon-managed skill
- [compozy skill](https://compozy.com/docs/cli/skill): Manage local AgentSkills
- [compozy skill info](https://compozy.com/docs/cli/skill/info): Show one Marketplace skill entry
- [compozy skill inspect](https://compozy.com/docs/cli/skill/inspect): Inspect installed skill metadata and resources
- [compozy skill install](https://compozy.com/docs/cli/skill/install): Install a marketplace skill
- [compozy skill list](https://compozy.com/docs/cli/skill/list): List locally available skills
- [compozy skill remove](https://compozy.com/docs/cli/skill/remove): Remove an installed marketplace skill
- [compozy skill search](https://compozy.com/docs/cli/skill/search): Search marketplace skills
- [compozy skill update](https://compozy.com/docs/cli/skill/update): Check for or install updates for marketplace skills
- [compozy skill view](https://compozy.com/docs/cli/skill/view): Read a skill or one of its resource files
- [compozy skill where](https://compozy.com/docs/cli/skill/where): Show every path participating in skill resolution
- [compozy scheduler backlog](https://compozy.com/docs/cli/scheduler/backlog): List queued runs visible to scheduler dispatch
- [compozy scheduler drain](https://compozy.com/docs/cli/scheduler/drain): Pause dispatch and wait for active task claims to finish
- [compozy scheduler](https://compozy.com/docs/cli/scheduler): Inspect and control task scheduler dispatch
- [compozy scheduler pause](https://compozy.com/docs/cli/scheduler/pause): Pause new scheduler dispatch
- [compozy scheduler resume](https://compozy.com/docs/cli/scheduler/resume): Resume scheduler dispatch
- [compozy scheduler status](https://compozy.com/docs/cli/scheduler/status): Show scheduler pause and queue pressure
- [compozy support bundle](https://compozy.com/docs/cli/support/bundle): Create and download a redacted support bundle
- [compozy support](https://compozy.com/docs/cli/support): Create daemon-owned support artifacts
- [compozy tool approve](https://compozy.com/docs/cli/tool/approve): Mint a one-shot approval token for one tool invocation
- [compozy tool](https://compozy.com/docs/cli/tool): Inspect and invoke registry tools
- [compozy tool info](https://compozy.com/docs/cli/tool/info): Show one registry tool descriptor and diagnostics
- [compozy tool invoke](https://compozy.com/docs/cli/tool/invoke): Invoke one registry tool through daemon policy
- [compozy tool list](https://compozy.com/docs/cli/tool/list): List operator-visible registry tools
- [compozy tool search](https://compozy.com/docs/cli/tool/search): Search operator-visible registry tools
- [compozy task approve](https://compozy.com/docs/cli/task/approve): Approve a task and enqueue its first run
- [compozy task block](https://compozy.com/docs/cli/task/block): Block a task with a typed reason
- [compozy task blocks](https://compozy.com/docs/cli/task/blocks): List task blocks
- [compozy task cancel](https://compozy.com/docs/cli/task/cancel): Cancel a task tree
- [compozy task complete](https://compozy.com/docs/cli/task/complete): Complete a claimed task run for the current agent session
- [compozy task create](https://compozy.com/docs/cli/task/create): Create a task
- [compozy task delete](https://compozy.com/docs/cli/task/delete): Delete a task
- [compozy task fail](https://compozy.com/docs/cli/task/fail): Fail task runs through a session-bound lease or operator override
- [compozy task fan-out](https://compozy.com/docs/cli/task/fan-out): Enqueue designated sibling runs for one task
- [compozy task get](https://compozy.com/docs/cli/task/get): Show one task with related detail
- [compozy task heartbeat](https://compozy.com/docs/cli/task/heartbeat): Extend a claimed task run lease for the current agent session
- [compozy task](https://compozy.com/docs/cli/task): Manage tasks and task runs
- [compozy task inspect](https://compozy.com/docs/cli/task/inspect): Inspect a task or run with diagnostics
- [compozy task list](https://compozy.com/docs/cli/task/list): List tasks
- [compozy task next](https://compozy.com/docs/cli/task/next): Claim the next task run for the current agent session
- [compozy task pause](https://compozy.com/docs/cli/task/pause): Pause new runs for one task
- [compozy task promote](https://compozy.com/docs/cli/task/promote): Promote one network thread message into a task
- [compozy task publish](https://compozy.com/docs/cli/task/publish): Publish a draft task and enqueue its first run
- [compozy task recover](https://compozy.com/docs/cli/task/recover): Recover a task from needs_attention
- [compozy task reject](https://compozy.com/docs/cli/task/reject): Reject a pending approval task
- [compozy task release](https://compozy.com/docs/cli/task/release): Force release claimed task runs back to the queue
- [compozy task resume](https://compozy.com/docs/cli/task/resume): Resume new runs for one paused task
- [compozy task retry](https://compozy.com/docs/cli/task/retry): Retry one failed task run
- [compozy task start](https://compozy.com/docs/cli/task/start): Enqueue a run for an executable task
- [compozy task unblock](https://compozy.com/docs/cli/task/unblock): Clear one task block
- [compozy task update](https://compozy.com/docs/cli/task/update): Update mutable task fields
- [compozy toolsets](https://compozy.com/docs/cli/toolsets): Inspect registry toolsets
- [compozy toolsets info](https://compozy.com/docs/cli/toolsets/info): Show one registry toolset expansion
- [compozy toolsets list](https://compozy.com/docs/cli/toolsets/list): List registry toolsets
- [compozy vault delete](https://compozy.com/docs/cli/vault/delete): Delete one vault secret
- [compozy vault get](https://compozy.com/docs/cli/vault/get): Show redacted metadata for one vault secret
- [compozy vault](https://compozy.com/docs/cli/vault): Manage encrypted daemon vault metadata and write-only secrets
- [compozy vault list](https://compozy.com/docs/cli/vault/list): List redacted vault secret metadata
- [compozy vault put](https://compozy.com/docs/cli/vault/put): Store one write-only vault secret from stdin
- [compozy window activate](https://compozy.com/docs/cli/window/activate): Activate one member of a window stack
- [compozy window close](https://compozy.com/docs/cli/window/close): Close or minimize a window and reflow its group
- [compozy window float](https://compozy.com/docs/cli/window/float): Toggle a window between floating and tiled placement
- [compozy window focus](https://compozy.com/docs/cli/window/focus): Focus a window by ID or direction for one connected client
- [compozy window group](https://compozy.com/docs/cli/window/group): Group windows into one ordered stack
- [compozy window](https://compozy.com/docs/cli/window): Manage windows in virtual desktops
- [compozy window list](https://compozy.com/docs/cli/window/list): List windows across workspace desktops
- [compozy window move](https://compozy.com/docs/cli/window/move): Move a window or tiled group to an explicit destination
- [compozy window navigate](https://compozy.com/docs/cli/window/navigate): Persist a window's internal application route
- [compozy window open](https://compozy.com/docs/cli/window/open): Open a window or restore a minimized window
- [compozy window pin](https://compozy.com/docs/cli/window/pin): Pin one managed window
- [compozy window reopen](https://compozy.com/docs/cli/window/reopen): Restore the newest closed window entry
- [compozy window resize](https://compozy.com/docs/cli/window/resize): Resize a window frame; a tiled split member detaches into its own island
- [compozy window swap](https://compozy.com/docs/cli/window/swap): Swap two window placements
- [compozy window unpin](https://compozy.com/docs/cli/window/unpin): Unpin one managed window
- [compozy window zoom](https://compozy.com/docs/cli/window/zoom): Toggle a window's client-specific focus desktop
- [compozy workspace add](https://compozy.com/docs/cli/workspace/add): Register a workspace
- [compozy workspace edit](https://compozy.com/docs/cli/workspace/edit): Edit a registered workspace
- [compozy workspace](https://compozy.com/docs/cli/workspace): Manage registered workspaces
- [compozy workspace info](https://compozy.com/docs/cli/workspace/info): Show one workspace with resolved details
- [compozy workspace list](https://compozy.com/docs/cli/workspace/list): List registered workspaces
- [compozy workspace remove](https://compozy.com/docs/cli/workspace/remove): Remove a workspace registration and stopped session history
- [compozy worktree adopt](https://compozy.com/docs/cli/worktree/adopt): Adopt an existing linked worktree
- [compozy worktree cancel](https://compozy.com/docs/cli/worktree/cancel): Cancel a pending worktree creation
- [compozy worktree commit](https://compozy.com/docs/cli/worktree/commit): Commit worktree changes
- [compozy worktree create](https://compozy.com/docs/cli/worktree/create): Create a worktree
- [compozy worktree dismiss](https://compozy.com/docs/cli/worktree/dismiss): Dismiss a worktree tombstone
- [compozy worktree exit-cancel](https://compozy.com/docs/cli/worktree/exit-cancel): Cancel a running worktree exit action
- [compozy worktree exit](https://compozy.com/docs/cli/worktree/exit): Read the worktree exit plan
- [compozy worktree](https://compozy.com/docs/cli/worktree): Manage workspace worktrees
- [compozy worktree inspect](https://compozy.com/docs/cli/worktree/inspect): Inspect a worktree
- [compozy worktree list](https://compozy.com/docs/cli/worktree/list): List registered worktrees
- [compozy worktree pr](https://compozy.com/docs/cli/worktree/pr): Open a pull request for the worktree
- [compozy worktree push](https://compozy.com/docs/cli/worktree/push): Push the worktree branch
- [compozy worktree remove](https://compozy.com/docs/cli/worktree/remove): Remove a worktree
- [compozy worktree status](https://compozy.com/docs/cli/worktree/status): Read or refresh worktree status
- [compozy agent heartbeat delete](https://compozy.com/docs/cli/agent/heartbeat/delete): Delete HEARTBEAT.md through managed authoring
- [compozy agent heartbeat history](https://compozy.com/docs/cli/agent/heartbeat/history): List managed Heartbeat authoring revisions
- [compozy agent heartbeat](https://compozy.com/docs/cli/agent/heartbeat): Inspect and manage agent HEARTBEAT.md files
- [compozy agent heartbeat inspect](https://compozy.com/docs/cli/agent/heartbeat/inspect): Inspect one agent's resolved Heartbeat policy
- [compozy agent heartbeat rollback](https://compozy.com/docs/cli/agent/heartbeat/rollback): Rollback HEARTBEAT.md to a managed revision or snapshot digest
- [compozy agent heartbeat status](https://compozy.com/docs/cli/agent/heartbeat/status): Read Heartbeat policy status and wake eligibility
- [compozy agent heartbeat validate](https://compozy.com/docs/cli/agent/heartbeat/validate): Validate a proposed Heartbeat policy body
- [compozy agent heartbeat wake](https://compozy.com/docs/cli/agent/heartbeat/wake): Request one manual advisory Heartbeat wake
- [compozy agent heartbeat write](https://compozy.com/docs/cli/agent/heartbeat/write): Create or replace HEARTBEAT.md through managed authoring
- [compozy agent soul delete](https://compozy.com/docs/cli/agent/soul/delete): Delete SOUL.md through managed authoring
- [compozy agent soul history](https://compozy.com/docs/cli/agent/soul/history): List managed Soul authoring revisions
- [compozy agent soul](https://compozy.com/docs/cli/agent/soul): Inspect and manage agent SOUL.md files
- [compozy agent soul inspect](https://compozy.com/docs/cli/agent/soul/inspect): Inspect one agent's resolved Soul
- [compozy agent soul rollback](https://compozy.com/docs/cli/agent/soul/rollback): Rollback SOUL.md to a managed revision
- [compozy agent soul validate](https://compozy.com/docs/cli/agent/soul/validate): Validate a proposed Soul body or the current SOUL.md
- [compozy agent soul write](https://compozy.com/docs/cli/agent/soul/write): Create or replace SOUL.md through managed authoring
- [compozy automation jobs create](https://compozy.com/docs/cli/automation/jobs/create): Create an automation job
- [compozy automation jobs delete](https://compozy.com/docs/cli/automation/jobs/delete): Delete an automation job
- [compozy automation jobs get](https://compozy.com/docs/cli/automation/jobs/get): Show one automation job
- [compozy automation jobs history](https://compozy.com/docs/cli/automation/jobs/history): Show run history for one automation job
- [compozy automation jobs](https://compozy.com/docs/cli/automation/jobs): Manage automation jobs
- [compozy automation jobs trigger](https://compozy.com/docs/cli/automation/jobs/trigger): Force an immediate automation job run
- [compozy automation jobs update](https://compozy.com/docs/cli/automation/jobs/update): Update an automation job
- [compozy automation runs get](https://compozy.com/docs/cli/automation/runs/get): Show one automation run
- [compozy automation runs](https://compozy.com/docs/cli/automation/runs): Inspect automation run history
- [compozy automation suggestions accept](https://compozy.com/docs/cli/automation/suggestions/accept): Accept a suggestion and create its Job
- [compozy automation suggestions dismiss](https://compozy.com/docs/cli/automation/suggestions/dismiss): Dismiss an automation suggestion
- [compozy automation suggestions](https://compozy.com/docs/cli/automation/suggestions): Review consent-first automation suggestions
- [compozy automation triggers create](https://compozy.com/docs/cli/automation/triggers/create): Create an automation trigger
- [compozy automation triggers delete](https://compozy.com/docs/cli/automation/triggers/delete): Delete an automation trigger
- [compozy automation triggers get](https://compozy.com/docs/cli/automation/triggers/get): Show one automation trigger
- [compozy automation triggers history](https://compozy.com/docs/cli/automation/triggers/history): Show run history for one automation trigger
- [compozy automation triggers](https://compozy.com/docs/cli/automation/triggers): Manage automation triggers
- [compozy automation triggers update](https://compozy.com/docs/cli/automation/triggers/update): Update an automation trigger
- [compozy bridge manifest](https://compozy.com/docs/cli/bridge/manifest): Generate provider setup artifacts
- [compozy bridge manifest slack](https://compozy.com/docs/cli/bridge/manifest/slack): Generate a Slack app manifest for one bridge instance
- [compozy bridge secret-bindings delete](https://compozy.com/docs/cli/bridge/secret-bindings/delete): Delete one bridge secret binding
- [compozy bridge secret-bindings](https://compozy.com/docs/cli/bridge/secret-bindings): Manage bridge secret bindings
- [compozy bridge secret-bindings list](https://compozy.com/docs/cli/bridge/secret-bindings/list): List secret bindings for one bridge instance
- [compozy bridge secret-bindings put](https://compozy.com/docs/cli/bridge/secret-bindings/put): Create or update one bridge secret binding
- [compozy bridge setup discord](https://compozy.com/docs/cli/bridge/setup/discord): Configure a discord bridge
- [compozy bridge setup](https://compozy.com/docs/cli/bridge/setup): Configure a bridge instance and its write-only secrets
- [compozy bridge setup telegram](https://compozy.com/docs/cli/bridge/setup/telegram): Configure a telegram bridge
- [compozy bridge setup whatsapp](https://compozy.com/docs/cli/bridge/setup/whatsapp): Configure a whatsapp bridge
- [compozy desktop clients](https://compozy.com/docs/cli/desktop/clients): Manage connected window-manager clients
- [compozy desktop clients list](https://compozy.com/docs/cli/desktop/clients/list): List connected client-local desktop views
- [compozy desktop clients register](https://compozy.com/docs/cli/desktop/clients/register): Register or refresh a client-local desktop view
- [compozy desktop clients unregister](https://compozy.com/docs/cli/desktop/clients/unregister): Remove a connected client-local view
- [compozy gateway provider disable](https://compozy.com/docs/cli/gateway/provider/disable): Disable a connectivity provider for one tier
- [compozy gateway provider enable](https://compozy.com/docs/cli/gateway/provider/enable): Enable a connectivity provider for one tier
- [compozy gateway provider](https://compozy.com/docs/cli/gateway/provider): Manage connectivity providers
- [compozy gateway surface disable](https://compozy.com/docs/cli/gateway/surface/disable): Disable one gateway surface
- [compozy gateway surface enable](https://compozy.com/docs/cli/gateway/surface/enable): Enable one gateway surface
- [compozy gateway surface](https://compozy.com/docs/cli/gateway/surface): Manage gateway surface exposure
- [compozy extension secrets bind](https://compozy.com/docs/cli/extension/secrets/bind): Bind one declared environment name to an existing extension Vault ref
- [compozy extension secrets](https://compozy.com/docs/cli/extension/secrets): Manage write-only extension environment bindings
- [compozy extension secrets list](https://compozy.com/docs/cli/extension/secrets/list): List declared and bound environment names without values
- [compozy extension secrets set](https://compozy.com/docs/cli/extension/secrets/set): Set one declared extension secret from hidden input
- [compozy extension secrets unset](https://compozy.com/docs/cli/extension/secrets/unset): Remove one extension environment binding
- [compozy loop node cancel](https://compozy.com/docs/cli/loop/node/cancel): Cancel one Loop node
- [compozy loop node](https://compozy.com/docs/cli/loop/node): Manage one authored Loop node
- [compozy loop node kill](https://compozy.com/docs/cli/loop/node/kill): Kill one Loop node
- [compozy loop node pause](https://compozy.com/docs/cli/loop/node/pause): Pause one Loop node
- [compozy loop node requeue](https://compozy.com/docs/cli/loop/node/requeue): Requeue one quarantined Loop node
- [compozy loop node resume](https://compozy.com/docs/cli/loop/node/resume): Resume one Loop node or manual wait
- [compozy mcp auth](https://compozy.com/docs/cli/mcp/auth): Authenticate remote MCP servers through the daemon
- [compozy mcp auth login](https://compozy.com/docs/cli/mcp/auth/login): Authorize a remote MCP server through the daemon
- [compozy mcp auth logout](https://compozy.com/docs/cli/mcp/auth/logout): Revoke or delete remote MCP auth tokens through the daemon
- [compozy mcp auth status](https://compozy.com/docs/cli/mcp/auth/status): Show redacted remote MCP auth status
- [compozy memory adhoc](https://compozy.com/docs/cli/memory/adhoc): Inspect ad-hoc Memory v2 notes
- [compozy memory adhoc list](https://compozy.com/docs/cli/memory/adhoc/list): Reserved Memory v2 command
- [compozy memory adhoc show](https://compozy.com/docs/cli/memory/adhoc/show): Reserved Memory v2 command
- [compozy memory daily archive](https://compozy.com/docs/cli/memory/daily/archive): Reserved Memory v2 command
- [compozy memory daily](https://compozy.com/docs/cli/memory/daily): Inspect Memory v2 daily operation logs
- [compozy memory daily ls](https://compozy.com/docs/cli/memory/daily/ls): List Memory v2 daily operation logs
- [compozy memory daily purge](https://compozy.com/docs/cli/memory/daily/purge): Reserved Memory v2 command
- [compozy memory daily restore](https://compozy.com/docs/cli/memory/daily/restore): Reserved Memory v2 command
- [compozy memory daily show](https://compozy.com/docs/cli/memory/daily/show): Reserved Memory v2 command
- [compozy memory decisions](https://compozy.com/docs/cli/memory/decisions): Inspect and revert Memory v2 controller decisions
- [compozy memory decisions list](https://compozy.com/docs/cli/memory/decisions/list): List Memory v2 controller decisions
- [compozy memory decisions revert](https://compozy.com/docs/cli/memory/decisions/revert): Revert one Memory v2 controller decision
- [compozy memory decisions show](https://compozy.com/docs/cli/memory/decisions/show): Show one Memory v2 controller decision
- [compozy memory dream](https://compozy.com/docs/cli/memory/dream): Operate Memory v2 dreaming runs
- [compozy memory dream retry](https://compozy.com/docs/cli/memory/dream/retry): Retry one failed Memory v2 dreaming run
- [compozy memory dream show](https://compozy.com/docs/cli/memory/dream/show): Show one Memory v2 dreaming run
- [compozy memory dream status](https://compozy.com/docs/cli/memory/dream/status): Show Memory v2 dreaming runtime status
- [compozy memory dream trigger](https://compozy.com/docs/cli/memory/dream/trigger): Trigger Memory v2 dreaming
- [compozy memory extractor disable](https://compozy.com/docs/cli/memory/extractor/disable): Reserved Memory v2 command
- [compozy memory extractor drain](https://compozy.com/docs/cli/memory/extractor/drain): Drain Memory v2 extractor work
- [compozy memory extractor](https://compozy.com/docs/cli/memory/extractor): Operate Memory v2 extractor runtime
- [compozy memory extractor list-failures](https://compozy.com/docs/cli/memory/extractor/list-failures): List Memory v2 extractor failure records
- [compozy memory extractor replay](https://compozy.com/docs/cli/memory/extractor/replay): Replay Memory v2 extractor work
- [compozy memory extractor status](https://compozy.com/docs/cli/memory/extractor/status): Show Memory v2 extractor runtime status
- [compozy memory provider disable](https://compozy.com/docs/cli/memory/provider/disable): Disable one Memory v2 provider
- [compozy memory provider enable](https://compozy.com/docs/cli/memory/provider/enable): Enable and select one Memory v2 provider
- [compozy memory provider](https://compozy.com/docs/cli/memory/provider): Operate Memory v2 providers
- [compozy memory provider list](https://compozy.com/docs/cli/memory/provider/list): List registered Memory v2 providers
- [compozy memory recall](https://compozy.com/docs/cli/memory/recall): Inspect Memory v2 recall traces
- [compozy memory recall trace](https://compozy.com/docs/cli/memory/recall/trace): Show one redaction-safe recall trace
- [compozy network channels create](https://compozy.com/docs/cli/network/channels/create): Create a runtime channel and start one session per selected agent
- [compozy network channels](https://compozy.com/docs/cli/network/channels): List active runtime channels
- [compozy network channels update](https://compozy.com/docs/cli/network/channels/update): Update runtime channel routing metadata
- [compozy network coordination disable](https://compozy.com/docs/cli/network/coordination/disable): Disable workspace coordination conversations
- [compozy network coordination enable](https://compozy.com/docs/cli/network/coordination/enable): Enable workspace coordination conversations
- [compozy network coordination](https://compozy.com/docs/cli/network/coordination): Inspect or change workspace network coordination
- [compozy network coordination status](https://compozy.com/docs/cli/network/coordination/status): Show workspace network coordination and invitation state
- [compozy network directs](https://compozy.com/docs/cli/network/directs): Inspect restricted direct rooms
- [compozy network directs list](https://compozy.com/docs/cli/network/directs/list): List direct rooms in a channel
- [compozy network directs messages](https://compozy.com/docs/cli/network/directs/messages): List messages in one direct room
- [compozy network directs resolve](https://compozy.com/docs/cli/network/directs/resolve): Create or return the deterministic direct room for two peers
- [compozy network directs show](https://compozy.com/docs/cli/network/directs/show): Show one direct room
- [compozy network invitation dismiss](https://compozy.com/docs/cli/network/invitation/dismiss): Dismiss the coordination invitation for a scope
- [compozy network invitation](https://compozy.com/docs/cli/network/invitation): Dismiss or reset the coordination invitation
- [compozy network invitation reset](https://compozy.com/docs/cli/network/invitation/reset): Reset the coordination invitation for a scope
- [compozy network subscriptions](https://compozy.com/docs/cli/network/subscriptions): Inspect network delivery preferences
- [compozy network subscriptions list](https://compozy.com/docs/cli/network/subscriptions/list): List network delivery preferences
- [compozy network threads](https://compozy.com/docs/cli/network/threads): Inspect public network threads
- [compozy network threads list](https://compozy.com/docs/cli/network/threads/list): List public threads in a channel
- [compozy network threads messages](https://compozy.com/docs/cli/network/threads/messages): List messages in one public thread
- [compozy network threads promote](https://compozy.com/docs/cli/network/threads/promote): Promote one thread message into a durable task
- [compozy network threads show](https://compozy.com/docs/cli/network/threads/show): Show one public thread
- [compozy network work](https://compozy.com/docs/cli/network/work): Inspect lifecycle-bearing network work
- [compozy network work lookup](https://compozy.com/docs/cli/network/work/lookup): Show one network work item
- [compozy notifications preset create](https://compozy.com/docs/cli/notifications/preset/create): Create a notification preset
- [compozy notifications preset delete](https://compozy.com/docs/cli/notifications/preset/delete): Delete a custom notification preset
- [compozy notifications preset disable](https://compozy.com/docs/cli/notifications/preset/disable): Disable a notification preset
- [compozy notifications preset enable](https://compozy.com/docs/cli/notifications/preset/enable): Enable a notification preset
- [compozy notifications preset](https://compozy.com/docs/cli/notifications/preset): Manage one notification preset
- [compozy notifications preset show](https://compozy.com/docs/cli/notifications/preset/show): Show one notification preset
- [compozy notifications preset update](https://compozy.com/docs/cli/notifications/preset/update): Update a notification preset
- [compozy notifications presets](https://compozy.com/docs/cli/notifications/presets): List notification presets
- [compozy notifications presets list](https://compozy.com/docs/cli/notifications/presets/list): List notification presets
- [compozy provider auth](https://compozy.com/docs/cli/provider/auth): Inspect native CLI and bound-secret provider authentication
- [compozy provider auth login](https://compozy.com/docs/cli/provider/auth/login): Run the provider native login command locally
- [compozy provider auth status](https://compozy.com/docs/cli/provider/auth/status): Show provider authentication status
- [compozy provider models](https://compozy.com/docs/cli/provider/models): Inspect and refresh the provider model catalog
- [compozy provider models list](https://compozy.com/docs/cli/provider/models/list): List provider model catalog entries
- [compozy provider models refresh](https://compozy.com/docs/cli/provider/models/refresh): Refresh provider model catalog sources
- [compozy provider models set](https://compozy.com/docs/cli/provider/models/set): Curate one provider model
- [compozy provider models status](https://compozy.com/docs/cli/provider/models/status): Show provider model catalog source status
- [compozy session attachments](https://compozy.com/docs/cli/session/attachments): Manage session attachments
- [compozy session attachments upload](https://compozy.com/docs/cli/session/attachments/upload): Upload a file to a session
- [compozy session soul](https://compozy.com/docs/cli/session/soul): Manage session Soul snapshots
- [compozy session soul refresh](https://compozy.com/docs/cli/session/soul/refresh): Refresh an idle session's Soul snapshot
- [compozy session runtime clear](https://compozy.com/docs/cli/session/runtime/clear): Clear the default runtime for future prompts
- [compozy session runtime](https://compozy.com/docs/cli/session/runtime): Manage the default runtime for future session prompts
- [compozy session runtime set](https://compozy.com/docs/cli/session/runtime/set): Select the default runtime for future prompts
- [compozy session input cancel](https://compozy.com/docs/cli/session/input/cancel): Cancel one queued session input
- [compozy session input edit](https://compozy.com/docs/cli/session/input/edit): Replace one queued session input
- [compozy session input](https://compozy.com/docs/cli/session/input): Manage pending session input
- [compozy session input list](https://compozy.com/docs/cli/session/input/list): List pending input for a session
- [compozy session input steer](https://compozy.com/docs/cli/session/input/steer): Promote queued input to fenced steering guidance
- [compozy session clarify answer](https://compozy.com/docs/cli/session/clarify/answer): Answer one live session question
- [compozy session clarify](https://compozy.com/docs/cli/session/clarify): Manage live session questions
- [compozy session clarify pending](https://compozy.com/docs/cli/session/clarify/pending): List live questions awaiting an operator answer
- [compozy tool approvals](https://compozy.com/docs/cli/tool/approvals): Manage remembered native-tool approval decisions
- [compozy tool approvals list](https://compozy.com/docs/cli/tool/approvals/list): List remembered native-tool approval decisions
- [compozy tool approvals revoke](https://compozy.com/docs/cli/tool/approvals/revoke): Revoke one remembered native-tool approval decision
- [compozy tool approvals set](https://compozy.com/docs/cli/tool/approvals/set): Set an explicit agent-wide or tool-wide approval decision
- [compozy tool artifact](https://compozy.com/docs/cli/tool/artifact): Read retained oversized tool results
- [compozy tool artifact read](https://compozy.com/docs/cli/tool/artifact/read): Read one workspace-scoped artifact page
- [compozy task child create](https://compozy.com/docs/cli/task/child/create): Create a child task beneath a parent
- [compozy task child](https://compozy.com/docs/cli/task/child): Manage child tasks
- [compozy task dependency add](https://compozy.com/docs/cli/task/dependency/add): Add a dependency edge to a task
- [compozy task dependency](https://compozy.com/docs/cli/task/dependency): Manage task dependencies
- [compozy task dependency remove](https://compozy.com/docs/cli/task/dependency/remove): Remove a dependency edge from a task
- [compozy task notification delete](https://compozy.com/docs/cli/task/notification/delete): Delete one bridge terminal notification subscription
- [compozy task notification](https://compozy.com/docs/cli/task/notification): Manage task terminal notifications
- [compozy task notification list](https://compozy.com/docs/cli/task/notification/list): List bridge terminal notification subscriptions for one task
- [compozy task notification show](https://compozy.com/docs/cli/task/notification/show): Show one bridge terminal notification subscription
- [compozy task notification subscribe](https://compozy.com/docs/cli/task/notification/subscribe): Subscribe a bridge target to task terminal notifications
- [compozy task profile delete](https://compozy.com/docs/cli/task/profile/delete): Delete one task execution profile
- [compozy task profile](https://compozy.com/docs/cli/task/profile): Manage task execution profiles
- [compozy task profile inspect](https://compozy.com/docs/cli/task/profile/inspect): Show one task execution profile
- [compozy task profile set-worktree](https://compozy.com/docs/cli/task/profile/set-worktree): Set a task worktree policy
- [compozy task profile update](https://compozy.com/docs/cli/task/profile/update): Replace one task execution profile
- [compozy task review](https://compozy.com/docs/cli/task/review): Manage task-run reviews
- [compozy task review list](https://compozy.com/docs/cli/task/review/list): List task-run reviews
- [compozy task review request](https://compozy.com/docs/cli/task/review/request): Request review for a task run
- [compozy task review show](https://compozy.com/docs/cli/task/review/show): Show one task-run review
- [compozy task review submit](https://compozy.com/docs/cli/task/review/submit): Submit one task-run review verdict
- [compozy task run attach-session](https://compozy.com/docs/cli/task/run/attach-session): Attach an existing session to a claimed or starting run
- [compozy task run cancel](https://compozy.com/docs/cli/task/run/cancel): Cancel a task run
- [compozy task run complete](https://compozy.com/docs/cli/task/run/complete): Complete a running task run
- [compozy task run enqueue](https://compozy.com/docs/cli/task/run/enqueue): Enqueue a task run
- [compozy task run fail](https://compozy.com/docs/cli/task/run/fail): Fail a task run
- [compozy task run](https://compozy.com/docs/cli/task/run): Manage task runs
- [compozy task run list](https://compozy.com/docs/cli/task/run/list): List runs for a task
- [compozy task run recover](https://compozy.com/docs/cli/task/run/recover): Recover one needs_attention task run
- [compozy task run show](https://compozy.com/docs/cli/task/run/show): Show a task run
- [compozy task run start](https://compozy.com/docs/cli/task/run/start): Start a claimed task run

## Blog

- [Introducing CompozyOS](https://compozy.com/blog/introducing-compozyos): CompozyOS v0.3 brings sessions, work, memory, permissions, automation, coordination, and an OS shell into one extensible local-first runtime.