Agent Burn

Getting Started

Run the local usage overview and add subscription value.

Run the overview:

npx agent-burn@latest summary

Add subscription value:

npx agent-burn@latest summary --value
npx agent-burn@latest summary --chart --html

Focus on one subscription harness:

npx agent-burn@latest harness claude --value
npx agent-burn@latest harness codex --value

Running agent-burn without a command is the same as agent-burn summary.

Date ranges

Use a quick range:

agent-burn summary today
agent-burn summary yesterday
agent-burn summary week
agent-burn summary --range month

Or explicit bounds:

agent-burn summary --since 20260601 --until 20260613

Plan overrides

Agent Burn auto-detects some plan details from local data when possible. You can override them:

agent-burn summary --value --claude-plan max-20x --codex-plan pro --cursor-plan ultra
agent-burn harness claude --value --claude-plan 200
agent-burn harness codex --value --codex-plan plus