Repolode
Submit
getagentseal

getagentseal/codeburn

Local CLI and desktop app that breaks down your AI coding token spend and cost by tool, model, project and task.

View on GitHubWebsite
Stars
11,521
Forks
969
Open issues
30
Last commit
2 days ago

What is it?

CodeBurn reads the session files that AI coding tools such as Claude Code, Codex, Cursor and Gemini CLI already write to your disk, then prices every token and shows where the money went. A monthly bill only gives a total, while CodeBurn breaks the spend down by project, model, git branch and task type, where task is inferred from the session itself, such as coding, debugging or planning.

Beyond reporting, it includes an optimize command that flags tokens spent without benefit, such as files re-read on every turn or unused MCP servers, and can apply and undo config changes with backups. It also tracks subscription plans and live quota, offers opt-in spending caps for Claude Code through hooks, and runs as a terminal dashboard, a web view, a macOS menu bar app, a Windows tray app and a Linux GNOME extension.

No account or API key is needed. It runs locally and makes no network calls of its own beyond fetching model prices, which come from LiteLLM and refresh daily. It is an npm package installable with npx, and the README lists support for 42 tools.

Key features

  • 01Breaks down spend by tool, model, project, git branch and task type.
  • 02Reads local session files from supported AI coding tools without an account.
  • 03Optimize command flags wasted tokens and can apply and undo config fixes with backups.
  • 04Tracks subscription plans and live quota limits for supported providers.
  • 05Opt-in Claude Code spending caps through hooks.
  • 06Offers terminal dashboard, web dashboard, macOS menu bar, Windows tray and Linux GNOME views.

Use cases

  • Finding which projects or branches drive most of your AI coding bill.
  • Comparing models on your own history to see whether a cheaper model holds up.
  • Checking whether a Claude Max or similar subscription fits your actual usage.
  • Auditing unused MCP servers and bloated CLAUDE.md files that add tokens to every request.

Quick start

  1. 1

    Run it instantly with npx (no install, no account)

    npx codeburn
  2. 2

    Install globally to keep it

    npm install -g codeburn
  3. 3

    Open the browser view of the same numbers

    codeburn web

Things to know

  • Requires Node.js 22.13 or newer for the CLI.
  • It only reads session files that supported tools already write to disk, so tools it does not list will not appear.
  • The desktop app and menu bar features are macOS, Windows and Linux specific and set up separately.

Topics

#ai-coding#token-usage#cost-tracking#claude-code#cli#observability#developer-tools#codex#cursor-ide#menubar

FAQ

What is codeburn?
Local CLI and desktop app that breaks down your AI coding token spend and cost by tool, model, project and task. CodeBurn reads the session files that AI coding tools such as Claude Code, Codex, Cursor and Gemini CLI already write to your disk, then prices every token and shows where the money went. A monthly bill only gives a total, while CodeBurn breaks the spend down by project, model, git branch and task type, where task is inferred from the session itself, such as coding, debugging or planning.
Is codeburn free to use? What license does it have?
codeburn is open source under the MIT license. Check the license terms before using it in commercial products.
Is codeburn still maintained?
Actively maintained. The last commit to codeburn was on Oct 17, 2026.
What can I use codeburn for?
Finding which projects or branches drive most of your AI coding bill. Comparing models on your own history to see whether a cheaper model holds up. Checking whether a Claude Max or similar subscription fits your actual usage. Auditing unused MCP servers and bloated CLAUDE.md files that add tokens to every request.
How do I install codeburn?
Run it instantly with npx (no install, no account): npx codeburn Install globally to keep it: npm install -g codeburn Open the browser view of the same numbers: codeburn web
Where can I get codeburn?
The source code and installation instructions are on GitHub: https://github.com/getagentseal/codeburn

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects