Skip to content

compozy session usage

Show aggregated session token usage and cost provenance

For people running agent work24 pages in this section

compozy session usage

Show aggregated session token usage 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

Options

  -h, --help   help for usage

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

On this page