compozy

Compozy — agent operating system

compozy [flags]

Examples

  # Start the daemon and create a session in the current workspace
  compozy daemon start
  compozy session new --agent general

  # Print machine-readable output for automation
  compozy session list -o json

Options

  -h, --help            help for compozy
      --json            Emit JSON output
  -o, --output string   Output format: human, json, jsonl, or toon (default "human")

Output Formats

Every Compozy command supports -o, --output:

human for interactive terminal use
json for scripts and other machine-readable consumers
jsonl for wait or streaming commands that emit one JSON record per line
toon for compact agent-readable summaries

Example:

compozy -o json

Subcommands

Command	Description
compozy agent	Inspect Compozy agent definitions
compozy automation	Manage automation jobs, triggers, suggestions, and runs
compozy bridge	Manage bridge instances
compozy bundle	Manage extension bundle presets
compozy ch	Use agent-facing coordination channels
compozy completion	Generate the autocompletion script for the specified shell
compozy config	Inspect and mutate Compozy configuration
compozy daemon	Manage the Compozy daemon
compozy desktop	Manage virtual desktops in a workspace
compozy doctor	Run runtime diagnostics
compozy drain	Stop admitting new work while in-flight work completes
compozy extension	Manage Compozy extensions
compozy hooks	Inspect configured and executed hooks
compozy install	Bootstrap Compozy and create the default general agent
compozy layout	Inspect, preview, and change workspace layouts
compozy layout-profile	List, read, save, and delete saved layouts
compozy logs	Read cross-session runtime logs
compozy loop	Manage Loop definitions and runs
compozy marketplace	Discover installable Compozy capabilities
compozy mcp	Manage MCP integrations
compozy me	Inspect the current Compozy-managed agent session
compozy memory	Show, write, search, and operate Memory v2 durable context
compozy network	Operate the daemon-owned network runtime
compozy notifications	Manage notification presets
compozy observe	Inspect runtime observability read models
compozy onboarding	Inspect and manage first-run onboarding state
compozy open	Open the Compozy web UI in the default browser
compozy provider	Inspect and manage provider authentication
compozy resource	Manage desired-state resources
compozy roles	Inspect effective background role configuration
compozy scheduler	Inspect and control task scheduler dispatch
compozy session	Manage Compozy sessions
compozy skill	Manage local AgentSkills
compozy spawn	Spawn a bounded child agent session
compozy status	Show consolidated runtime status
compozy support	Create daemon-owned support artifacts
compozy task	Manage tasks and task runs
compozy tool	Inspect and invoke registry tools
compozy toolsets	Inspect registry toolsets
compozy undrain	Resume admission of new work
compozy uninstall	Stop Compozy and remove runtime launch artifacts
compozy update	Check for and apply the latest stable Compozy release
compozy vault	Manage encrypted daemon vault metadata and write-only secrets
compozy version	Print the Compozy version
compozy whoami	Print the current Compozy agent identity from environment variables
compozy window	Manage windows in virtual desktops
compozy workspace	Manage registered workspaces

compozy

Examples

Options

Output Formats

Subcommands

On this page