Skip to content

compozy logs

Read cross-session runtime logs

For people running agent work514 pages in this section

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

The root -o, --output flag accepts these values. A renderer is supported only when this command writes that result; jsonl is for commands that emit one JSON record per line.

FormatCommand result
humanInteractive terminal rendering
jsonMachine-readable JSON rendering
jsonlOne JSON record per line when supported
toonCompact agent-readable rendering

Example:

compozy logs -o json

On this page