Skip to content

compozy session usage

Show session tokens, context, and cost provenance

For people running agent work55 pages in this section

compozy session usage

Show session tokens, context, and cost provenance

compozy session usage <session-id> [flags]

Examples

  # Show truthful token and cost totals
  compozy session usage sess_1234

  # Read the usage contract as JSON for scripts
  compozy session usage sess_1234 -o json

  # Inspect each turn and replay compaction span
  compozy session usage sess_1234 --turns

Options

  -h, --help    help for usage
      --turns   Show per-turn usage, deliveries, and replay compaction spans

Options inherited from parent commands

      --json             Emit JSON output
  -o, --output string    Output format: human, json, jsonl, or toon (default "human")
      --profile string   Act as a profile for this command

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 usage <session-id> -o json

On this page