Agent BurnCLI Options
Public flags for summary, harness, and shared output.
Commands
agent-burn summary [range]
agent-burn harness <claude|codex>Summary
summary aggregates detected local usage, shows each selected day's cost and tokens in a compact visual breakdown, and optionally calculates subscription value.
agent-burn summary
agent-burn summary --value
agent-burn summary yesterday
agent-burn summary week --value
agent-burn summary --range month --jsonSummary-specific options:
| Option | Description |
|---|---|
--range <today|yesterday|wtd|mtd|ytd|week|month> | Apply a quick date range |
--value | Show subscription value |
--html | Write and open an interactive HTML report with daily model/agent charts |
--chart | Append a day-by-day stacked-by-model chart to the terminal |
--claude-plan <plan|price> | Override Claude plan |
--codex-plan <plan|price> | Override Codex plan |
--cursor-plan <plan|price> | Override Cursor plan (pro, pro+, ultra, or a monthly price) |
Harness
harness focuses on one subscription window. The terminal view includes a trailing-30-day spend mix for input, output, cache write, and cached input tokens, with each class' token share and API-equivalent cost share.
agent-burn harness claude --value
agent-burn harness codex --value
agent-burn harness claude --json --offlineHarness-specific options:
| Option | Description |
|---|---|
--value | Show API-equivalent value against the monthly plan |
--claude-plan <pro|max-5x|max-20x|price> | Override Claude plan |
--codex-plan <plus|pro|price> | Override Codex plan |
Shared options
| Option | Description |
|---|---|
--since <YYYYMMDD> | Include usage on or after the date |
--until <YYYYMMDD> | Include usage on or before the date |
--json | Print JSON |
--jq <filter> | Apply a jq filter to JSON |
--mode <auto|calculate|display> | Cost mode |
--breakdown | Include model breakdowns |
--offline | Use embedded pricing and skip live requests |
--no-offline | Force online pricing requests when supported |
--color | Force color |
--no-color | Disable color |
--timezone <tz> | Group dates in a timezone |
--config <path> | Load a config file |
--compact | Force compact table layout |
--single-thread | Disable parallel loading |
--no-cost | Hide cost fields |