codeburn

CodeBurn tracks token usage, cost, and performance across 25 AI coding tools. It breaks down spending by task type, model, tool, project, and provider so you can see exactly where your budget goes.

Everything runs locally. No wrapper, no proxy, no API keys. CodeBurn reads session data directly from disk and prices every call using LiteLLM.

Requirements

• Node.js 20+
• At least one supported AI coding tool with session data on disk
• For Cursor and OpenCode support, better-sqlite3 is installed automatically as an optional dependency

Install

npm install -g codeburn

Or with Homebrew:

brew install codeburn

Or run directly without installing:

npx codeburn
bunx codeburn
dx codeburn

Usage

codeburn                        # interactive dashboard (default: 7 days)
codeburn today                  # today's usage
codeburn month                  # this month's usage
codeburn report -p 30days       # rolling 30-day window
codeburn report -p all          # every recorded session
codeburn report --from 2026-04-01 --to 2026-04-10  # exact date range
codeburn report --format json   # full dashboard data as JSON
codeburn report --refresh 60    # auto-refresh every 60s (default: 30s)
codeburn status                 # compact one-liner (today + month)
codeburn status --format json
codeburn export                 # CSV with today, 7 days, 30 days
codeburn export -f json         # JSON export
codeburn optimize               # find waste, get copy-paste fixes
codeburn optimize -p week       # scope the scan to last 7 days
codeburn compare                # side-by-side model comparison
codeburn yield                  # track productive vs reverted/abandoned spend
codeburn yield -p 30days        # yield analysis for last 30 days
codeburn models                 # per-model token + cost table (last 30 days)
codeburn models --by-task       # explode each model into per-task-type rows
codeburn models --top 10        # only the top 10 by cost
codeburn models --format markdown      # paste-friendly markdown table
codeburn models --task feature         # filter to feature-development work
codeburn models --provider claude      # filter to one provider

Arrow keys switch between Today, 7 Days, 30 Days, Month, and 6 Months (use --from / --to for an exact historical window). Press q to quit, 1 2 3 4 5 as shortcuts, c to open model comparison, o to open optimize. The dashboard auto-refreshes every 30 seconds by default (--refresh 0 to disable). It also shows average cost per session and the five most expensive sessions across all projects.

Supported Providers

| | Provider | Supported | Doc | |------------------------------------------------------------|----------------|-----------|---------------------------------------------------| | | Claude Code | Yes | claude.md | | | Claude Desktop | Yes | claude.md | | | Cline | Yes | cline.md | | | Codex (OpenAI) | Yes | codex.md | | | Cursor | Yes | cursor.md | | | cursor-agent | Yes | cursor-agent.md | | | Forge | Yes | forge.md | | | Gemini CLI | Yes | gemini.md | | | Mistral Vibe | Yes | mistral-vibe.md | | | GitHub Copilot | Yes | copilot.md | | | IBM Bob | Yes | ibm-bob.md | | | Kiro | Yes | kiro.md | | | OpenCode | Yes | opencode.md | | | OpenClaw | Yes | openclaw.md | | | Pi | Yes | pi.md | | | OMP (Oh My Pi) | Yes | omp.md | | | Droid | Yes | droid.md | | | Roo Code | Yes | roo-code.md | | | KiloCode | Yes | kilo-code.md | | | Qwen | Yes | qwen.md | | | Kimi Code CLI | Yes | kimi.md | | | Goose | Yes | goose.md | | | Antigravity | Yes | antigravity.md | | | Crush | Yes | crush.md | | | Warp | Yes | warp.md |

Each provider doc lists the exact data location, storage format, and known quirks. Linux and Windows paths are detected automatically. If a path has changed or is wrong, please open an issue.

CodeBurn auto-detects which AI coding tools you use. If multiple providers have session data on disk, press p in the dashboard to toggle between them.

The --provider flag filters any command to a single provider: codeburn report --provider claude, codeburn today --provider codex, codeburn export --provider cursor. Works on all commands: report, today, month, status, export, optimize, compare, yield.

Provider Notes

Cursor reads token usage from its local SQLite database. Since Cursor's "Auto" mode hides the actual model used, costs are estimated using Sonnet pricing (labeled "Auto (Sonnet est.)" in the dashboard). The Cursor view shows a Languages panel instead of Core Tools/Shell/MCP panels, since Cursor does not log individual tool calls. First run on a large Curso