Agent Burn
Get started
npx · pnpm dlx · bunx · nix

You already burned the tokens.

Agent Burn reads local Claude Code, Codex, and Cursor usage and answers one question: is the subscription paying for itself?

Read the docsSource
A representative Agent Burn terminal report. Five days of local usage with API-equivalent cost, then subscription value against Claude, Codex, and Cursor plan prices.

The bill

The weekly limit is not the price.

Dashboards tell you that you hit a cap. They do not tell you what those tokens would have cost at API rates, which day did the damage, or whether Max is cheaper than the usage you already ran.

What you see

Limit reached

A reset countdown. A vague “you are using the plan.” No model mix, no daily cost.

What local logs have

$186 of $200

API-equivalent spend by day, by model, by agent. Enough to decide if the plan is earning its keep.

Commands

summary for the pile. harness for the window.

The public CLI is two commands. Running agent-burn with no arguments is summary.

All-up

summary

Detected local usage across Claude, Codex, and Cursor. Quick ranges, explicit dates, optional value, chart, and HTML.

agent-burn summary week --value

One subscription

harness

Claude or Codex only. Weekly limit burn, reset timing, and a 30-day split of input, output, and cache tokens.

agent-burn harness codex --value

Sources

The files are already on disk.

Claude Code and Codex are the harness targets because they expose a useful weekly limit. Cursor still lands in summary, including charts and HTML.

  • Claude Code~/.claude and ~/.config/claude/projects
  • Codex${CODEX_HOME:-~/.codex}
  • Cursorlocal state.vscdb, then the signed-in dashboard usage API

Capabilities

What the CLI actually does.

No account, no upload, no wrapper bins. The report is local aggregation plus optional live limit data.

  • Summary

    Aggregate detected local usage, daily cost, token volume, and optional subscription value in one table.

    agent-burn summary --value

  • Harness

    Focus Claude Code or Codex on the current weekly limit, reset timing, and a trailing-30-day spend mix.

    agent-burn harness claude --value

  • Plan overrides

    Auto-detect when the local snapshot has a plan. Override with a named tier or a raw monthly price.

    --claude-plan max-20x

  • Offline pricing

    Embedded LiteLLM prices cover a fully local run. Skip live dashboard calls when you want a sealed report.

    --offline

  • Charts and HTML

    Stack daily spend by model in the terminal, or write an interactive HTML report and open it.

    summary --chart --html

  • Config files

    Keep timezone, cost mode, and offline defaults in JSON. CLI flags still win.

    --config ./agent-burn.json

Install

One line, then the report.

The npm package also installs burn as a short alias. Nix and package runners are documented in the install guide.

Installationnpm
$ npx agent-burn@latest summary --value

✓ local logs read
✓ prices resolved
✓ subscription value printed