CodeBurn
Local tool that tracks what your AI coding tools spend on tokens, broken down by model, project, and task.
- Stars
- 11.7k
- Forks
- 901
- Licence
- MIT
- Language
- TypeScript
- Last update
- 5 days ago
- Type
- Dev tool
What it is
CodeBurn reads the session files that AI coding tools such as Claude Code, Codex, and Cursor write to your disk, then prices every token and shows what you spent. It breaks the total down by tool, model, project, and task, so you can see where a monthly bill actually goes. It runs locally and the README says no account or sign-up is needed.
- Run npx codeburn to see today's spend and a per-model and per-project table in the terminal
- Run codeburn web to view the same numbers in a browser
- Use codeburn optimize to list findings that cost tokens without benefit, with estimated savings
- Set a plan with codeburn plan set and check remaining usage with codeburn quota
- Install optional Claude Code spending guards with codeburn guard install
Great for
- Developers who use several AI coding tools and want one view of spending
- People on a Claude subscription who want to see how much of their plan they have used
- Developers who want to find config bloat, such as unused MCP servers or oversized CLAUDE.md files
- Anyone comparing whether a workflow or model change actually lowered cost
Not ideal for
- People who want a hosted cloud dashboard across a team, since the README describes it as local
- Users of tools outside the supported list, because it only reads the session files of tools it integrates with
- Anyone needing exact billing reconciliation, since the README presents figures as estimates from session data and does not claim they match invoices
How to get it
- 1
Install with a package manager
You'll need: Node.js 22.13+
Run without installing
npx codeburnInstall globally with npm
npm install -g codeburnInstall with Homebrew
brew install codeburn - 2
Run it
- Run npx codeburn in a terminal to see today's total cost
- Use the arrow keys to move between time periods
- Press p to switch between tools and q to quit
- Run codeburn web to open the same data in your browser
- 3
Get the most out of it
- Use the Sessions view in the desktop app to click into an expensive session and see its turns
- Use Compare periods after changing a model or workflow to check whether cost actually fell
- Run codeburn optimize to review findings, and codeburn act report later to check whether fixes worked
- Set your subscription with codeburn plan set so spend is shown against your plan limits
- Install codeburn guard hooks if you want warnings at set dollar thresholds in Claude Code
Downloads
Strengths
- Runs locally with no account, and the README says it reads files already on your disk
- Covers many tools and breaks spend down by model, project, git branch, and task
- Optimize and undo commands back up files before changing them, which makes config edits reversible
Trade-offs
- Depends on each tool's session file format, so coverage can change when those tools update
- The README describes several surfaces (desktop app, menu bar, Capacity Dock) that appear to be macOS-focused, and the Windows and Linux feature set is not clearly stated
- README is truncated, so details on privacy of the desktop app and full command list are not verified here
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| codeburn (this) | 11.7k | Dev tool | beginner | 5 days ago | Developers who use several AI coding tools and want one view of spending |
| codebase-memory-mcp | 48k | Dev tool | intermediate | 4 days ago | Developers who use an MCP-capable AI coding agent on a large codebase |
| khazix-skills | 21.8k | Curated list | beginner | 1 months ago | Developers already using Claude Code, Codex, or another Agent Skills-compatible agent who want ready-made skills |
| loop-engineering | 11.7k | Learning resource | intermediate | 4 days ago | Developers who already use AI coding agents and want recurring repo chores like issue triage or CI checks |
| ECC | 295k | Dev tool | intermediate | 4 days ago | Developers who already use Claude Code and want a shared workflow for planning, testing and review |
| Understand-Anything | 89.7k | Dev tool | beginner | 11 days ago | Developers joining a new team who need to learn an unfamiliar codebase |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.