Agent
compozy agent
Inspect Compozy agent definitions
- Audience
- Operators running durable agent work
- Focus
- Agent guidance shaped for scanability, day-two clarity, and operator context.
compozy agent
Inspect Compozy agent definitions
Options
-h, --help help for agentOptions inherited from parent commands
--json Emit JSON output
-o, --output string Output format: human, json, jsonl, or toon (default "human")Output Formats
Every Compozy command supports -o, --output:
humanfor interactive terminal usejsonfor scripts and other machine-readable consumersjsonlfor wait or streaming commands that emit one JSON record per linetoonfor compact agent-readable summaries
Subcommands
| Command | Description |
|---|---|
| compozy agent create | Create a global or workspace-local agent definition |
| compozy agent delete | Durably delete an agent definition |
| compozy agent duplicate | Duplicate an agent definition without exposing secrets |
| compozy agent heartbeat | Inspect and manage agent HEARTBEAT.md files |
| compozy agent info | Show one agent definition |
| compozy agent list | List installed agent definitions |
| compozy agent soul | Inspect and manage agent SOUL.md files |
| compozy agent update | Update an agent definition for future sessions |