Skip to content

compozy session list

List sessions

For people running agent work44 pages in this section

compozy session list

List sessions

compozy session list [flags]

Examples

  # List active sessions
  compozy session list

  # Page all sessions for one agent in a workspace
  compozy session list --all --workspace checkout-api --agent reviewer --limit 25

Options

      --agent string       Filter by exact agent definition name
      --all                Include every session state when --state is omitted
      --all-workspaces     List sessions across every workspace
      --archived           Show only archived sessions
      --attention          Show only sessions that need operator attention
      --badge strings      Filter by exact badge (repeat or comma-separate)
      --cursor string      Continue from an opaque next_cursor
  -h, --help               help for list
      --include-archived   Include archived sessions
      --include-health     Include metadata-only health for returned sessions
      --limit int          Sessions per page (1-100)
      --parent string      Filter by exact parent session id
      --query string       Search session id, name, agent, provider, or channel
      --resumable          Show only sessions eligible for resume attach
      --root string        Filter by exact root session id (includes the root itself)
      --sort string        Sort by recent, last_activity, or attention
      --state string       Filter by state (starting|active|stopping|stopped)
      --summary            Show exact attention counts across workspaces
      --type string        Filter by session type (user|system|coordinator|spawned)
      --workspace string   Override workspace filter (ID, name, or path)
      --worktree string    Filter by exact worktree ID

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 session list -o json

On this page