Cli reference
compozy logs
Read cross-session runtime logs
- Audience
- Operators running durable agent work
- Focus
- Logs guidance shaped for scanability, day-two clarity, and operator context.
compozy logs
Read cross-session runtime logs
compozy logs [flags]Options
--actor string Filter by actor as kind:id
--after-seq int Replay logs after the supplied event summary sequence
--agent string Filter by agent name
--component string Filter by registry component
--error-only Show failure and warning outcomes only
--follow Stream new logs over SSE
-h, --help help for logs
--last int Show only the most recent N logs
--outcome string Filter by registry outcome
--provider string Filter by provider id
--run string Filter by task run id
--session string Filter by session id
--since string Show logs since an RFC3339 timestamp or relative duration
--type string Filter by event type
--workspace string Override workspace filter (ID, name, or path)Options 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
Example:
compozy logs -o json