GitHub - getagentseal/codeburn: See where your AI coding tokens go. Interactive TUI dashboard for Claude Code, Codex, and Cursor cost observability.

See where your AI coding tokens go. CodeBurn tracks token usage, cost, and performance across 18 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. | Dashboard | Menu Bar | | Optimize | Compare | - 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 npm install -g codeburn Or with Homebrew: brew tap getagentseal/codeburn brew install codeburn Or run directly without installing: npx codeburn bunx codeburn dx codeburn 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. | Provider | Supported | Doc | | |---|---|---|---| | Claude Code | Yes | claude.md | | | Claude Desktop | Yes | claude.md | | | Codex (OpenAI) | Yes | codex.md | | | Cursor | Yes | cursor.md | | | cursor-agent | Yes | cursor-agent.md | | | Gemini CLI | Yes | gemini.md | | | GitHub Copilot | Yes | copilot.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 | | | Goose | Yes | goose.md | | | Antigravity | Yes | antigravity.md | | | Crush | Yes | crush.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. Provider logos are trademarks of their respective owners. The icon set was sourced from tokscale (MIT) plus official vendor assets, used under nominative fair use for the purpose of identifying supported tools. 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 . 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 Cursor database may take up to a minute; results are cached and subsequent runs are instant. Gemini CLI stores sessions as single JSON files. Each session embeds real token counts (input, output, cached, thoughts) per message, so no estimation is needed. Gemini reports input tokens inclusive of cached; CodeBurn subtracts cached from input before pricing to avoid double charging. Kiro stores conversations as .chat JSON files. Token counts are estimated from content length. The underlying model is not exposed, so sessions are labeled kiro-auto and costed at Sonnet rates. GitHub Copilot reads from both ~/.copilot/session-state/ (legacy CLI) and VS Code's workspaceStorage/*/GitHub.copilot-chat/transcripts/ . The VS Code format has no explicit token counts; tokens are estimated from content length and the model is inferred from tool call ID prefixes. OpenClaw reads JSONL agent logs from ~/.openclaw/agents/ and also checks legacy paths (.clawdbot , .moltbot , .moldbot ). Roo Code and KiloCode are Cline-family VS Code extensions. CodeBurn reads ui_messages.json from each task directory and extracts token usage from api_req_started entries. Claude with multiple config directories. If you run Claude Code under more than one account or profile (e.g. ~/.claude-work and ~/.claude-personal ), point CLAUDE_CONFIG_DIRS at all of them at once: CLAUDE_CONFIG_DIRS=~/.claude-work:~/.claude-personal codeburn . Sessions across every directory are merged into one row per project so the totals reflect all your Claude usage in one place. Use : on POSIX, ; on Windows. Missing or unreadable directories in the list are skipped. Adding a new provider is a single file. See src/providers/codex.ts for an example. Prices every API call using input, output, cache read, cache write, and web search token counts. Fast mode multiplier for Claude. Pricing fetched from LiteLLM and cached locally for 24 hours. Hardcoded fallbacks for all Claude and GPT models to prevent mispricing. 13 categories classified from tool usage patterns and user message keywords. No LLM calls, fully deterministic. | Category | What triggers it | |---|---| | Coding | Edit, Write tools | | Debugging | Error/fix keywords + tool usage | | Feature Dev | "add", "create", "implement" keywords | | Refactoring | "refactor", "rename", "simplify" | | Testing | pytest, vitest, jest in Bash | | Exploration | Read, Grep, WebSearch without edits | | Planning | EnterPlanMode, TaskCreate tools | | Delegation | Agent tool spawns | | Git Ops | git push/commit/merge in Bash | | Build/Deploy | npm build, docker, pm2 | | Brainstorming | "brainstorm", "what if", "design" | | Conversation | No tools, pure text exchange | | General | Skill tool, uncategorized | Daily cost chart, per-project, per-model (Opus, Sonnet, Haiku, GPT-5, GPT-4o, Gemini, Kiro, and more), per-activity with one-shot rate, core tools, shell commands, and MCP servers. For categories that involve code edits, CodeBurn detects edit/test/fix retry cycles (Edit, Bash, Edit patterns). The one-shot column shows the percentage of edit turns that succeeded without retries. Coding at 90% means the AI got it right first try 9 out of 10 times. Fetched from LiteLLM model prices (auto-cached 24 hours at ~/.cache/codeburn/ ). Handles input, output, cache write, cache read, and web search costs. Fast mode multiplier for Claude. Hardcoded fallbacks for all Claude and GPT-5 models to prevent fuzzy matching mispricing. codeburn optimize # scan the last 30 days codeburn optimize -p today # today only codeburn optimize -p week # last 7 days codeburn optimize --provider claude # restrict to one provider Scans your sessions and your ~/.claude/ setup for waste patterns: - Files Claude re-reads across sessions (same content, same context, over and over) - Low Read:Edit ratio (editing without reading leads to retries and wasted tokens) - Wasted bash output (uncapped BASH_MAX_OUTPUT_LENGTH , trailing noise) - Unused MCP servers still paying their tool-schema overhead every session - Ghost agents, skills, and slash commands defined in ~/.claude/ but never invoked - Bloated CLAUDE.md files (with@-import expansion counted) - Cache creation overhead and junk directory reads - Context-heavy sessions where effective input/cache tokens swamp output - Possibly low-worth expensive sessions with no edit turns or repeated retries when no git /gh delivery command is observed Each finding shows the estimated token and dollar savings plus a ready-to-paste fix: a CLAUDE.md line, an environment variable, or a mv command to archive unused items. Findings are ranked by urgency (impact weighted against observed waste) and rolled up into an A to F setup health grade. Repeat runs classify each finding as new, improving, or resolved against a 48-hour recent window. You can also open it inline from the dashboard: press o when a finding count appears in the status bar, b to return. codeburn compare # interactive model picker (default: last 6 months) codeburn compare -p week # last 7 days codeburn compare -p today # today only codeburn compare --provider claude # Claude Code sessions only Or press c in the dashboard to enter compare mode. Arrow keys switch periods, b to return. | Section | Metric | What it measures | |---|---|---| | Performance | One-shot rate | Edits that succeed without retries | | Performance | Retry rate | Average retries per edit turn | | Performance | Self-correction | Turns where the model corrected its own mistake | | Efficiency | Cost per call | Average cost per API call | | Efficiency | Cost per edit | Average cost per edit turn | | Efficiency | Output tokens per call | Average output tokens per call | | Efficiency | Cache hit rate | Proportion of input from cache | Also compares per-category one-shot rates, delegation rate, planning rate, average tools per turn, and fast mode usage. codeburn yield # last 7 days (default) codeburn yield -p today # today only codeburn yield -p 30days # last 30 days codeburn yield -p month # this calendar month Correlates AI sessions with git commits by timestamp: | Category | Meaning | |---|---| | Productive | Commits from this session landed in main | | Reverted | Commits were later reverted | | Abandoned | No commits near session, or commits never merged | Requires a git repository. Run from your project directory. codeburn plan set claude-max # $200/month codeburn plan set claude-pro # $20/month codeburn plan set cursor-pro # $20/month codeburn plan set custom --monthly-usd 150 --provider claude # custom codeburn plan set none # disable plan view codeburn plan # show current codeburn plan reset # remove plan config Subscription tracking for Claude Pro, Claude Max, and Cursor Pro. The dashboard shows a progress bar of API-equivalent cost against your plan price. Supports custom plans. Presets use publicly stated plan prices (as of April 2026); they do not model exact token allowances, because vendors do not publish precise consumer-plan limits. codeburn currency GBP # set to British Pounds codeburn currency AUD # set to Australian Dollars codeburn currency JPY # set to Japanese Yen codeburn currency # show current setting codeburn currency --reset # back to USD Any ISO 4217 currency code is supported (162 currencies). Exchange rates fetched from Frankfurter (European Central Bank data, free, no API key) and cached for 24 hours. Config stored at ~/.config/codeburn/config.json . The currency setting applies everywhere: dashboard, status bar, menu bar, CSV/JSON exports, and JSON API output. If you see $0.00 for some models, the model name reported by your provider does not match any entry in the LiteLLM pricing data. This commonly happens when using a proxy that rewrites model names. codeburn model-alias "my-proxy-model" "claude-opus-4-6" # add alias codeburn model-alias --list # show configured aliases codeburn model-alias --remove "my-proxy-model" # remove alias Aliases are stored in ~/.config/codeburn/config.json and applied at runtime before pricing lookup. The target name can be anything in the LiteLLM model list or a canonical name from the fallback table (e.g. claude-sonnet-4-6 , claude-opus-4-5 , gpt-4o ). Built-in aliases ship for known proxy model name variants. User-configured aliases take precedence over built-ins. codeburn report --project myapp # show only projects matching "myapp" codeburn report --exclude myapp # show everything except "myapp" codeburn report --exclude myapp --exclude tests # exclude multiple projects codeburn month --project api --project web # include multiple projects codeburn export --project inventory # export only "inventory" project data Filter by provider, project name (case-insensitive substring), or exact date range. The --project and --exclude flags work on all commands and can be combined with --provider . codeburn report --from 2026-04-01 --to 2026-04-10 # explicit window codeburn report --from 2026-04-01 # this date through today codeburn report --to 2026-04-10 # earliest data through this date Either flag alone is valid. Inverted or malformed dates exit with a clear error. In the TUI, the custom range sets the initial load only; pressing 1 through 5 switches back to predefined periods. report , today , and month support --format json to output the full dashboard data as structured JSON to stdout: codeburn report --format json # 7-day JSON report codeburn today --format json # today's data as JSON codeburn month --format json # this month as JSON codeburn report -p 30days --format json # 30-day window The JSON includes all dashboard panels: overview (cost, calls, sessions, cache hit %), daily breakdown, projects (with avgCostPerSession ), models with token counts, activities with one-shot rates, core tools, MCP servers, and shell commands. Pipe to jq for filtering: codeburn report --format json | jq '.projects' codeburn today --format json | jq '.overview.cost' For lighter output, use status --format json (today and month totals only) or file exports (export -f json ). codeburn menubar One command: downloads the latest .app , installs into ~/Applications , and launches it. Re-run with --force to reinstall. Native Swift and SwiftUI app lives in mac/ (see mac/README.md for build details). The menubar icon always shows today's spend (so $0 is normal if you have not used AI tools today). Click to open a popover with agent tabs, period switcher (Today, 7 Days, 30 Days, Month, All), Trend, Forecast, Pulse, Stats, and Plan insights, activity and model breakdowns, optimize findings, and CSV/JSON export. Refreshes every 30 seconds. Compact mode shrinks the menubar item to fit the text, dropping decimals (e.g. $110 instead of $110.20 ): defaults write org.agentseal.codeburn-menubar CodeBurnMe