Overview
CodeBurn breaks down what you spend on AI coding tools. Your bill shows a monthly total; CodeBurn shows cost by tool, model, project, git branch and task (coding, debugging, planning), worked out from the session files your tools already save. It runs locally with no account, in the terminal, a desktop app, a browser view or the macOS menu bar.
Key capabilities
- Spend breakdown: by tool, model, project, branch and task.
- Session drill-down: click through to individual sessions and turns.
- Compare periods: check whether a model or workflow change actually saved money.
- Optimize: find wasted tokens and apply reversible fixes.
- Plans and quotas: track usage against subscriptions such as Claude Max.
- Guard: opt-in spending caps for Claude Code.
Tradeoffs
- Only sees tools that write local session files it understands.
- Prices are estimates from token counts, not your invoice.
- Optimize changes your config files; review before applying (backups are kept).
Ideal for
- Developers paying for several AI coding tools
- Teams tracking AI spend per project
- Heavy Claude Code users on a plan
Not ideal for
- Organization-wide billing reports
- Tools that don't store sessions locally
Getting started
- Run
npx codeburn(Node.js 22.15+). There's no account; it reads the session files your AI tools already write. - Use the arrow keys to change the period and
pto switch tools. Runcodeburn webfor the same view in a browser. - Run
codeburn optimizeto see what's wasting tokens; add--applyto review and apply fixes, andcodeburn act undo --lastto roll back. - Set your plan with
codeburn plan set claude-maxand check what's left withcodeburn quota.
Technical notes
- Run:
npx codeburn; install withnpm install -g codeburnorbrew install codeburn - Requires: Node.js 22.15+
- License: MIT
- Source: getagentseal/codeburn
- GitHub stars: 11,776 (as of 2026-11-12)