codeburn
Skill4 starsChanged 6 months agoMITView on GitHub
AI spend analytics — see where your token budget goes by task, model, tool, and project across 31 AI coding tools including Claude Code. Use when the user asks about AI costs, token usage, spend breakdown, or wants to optimize their AI budget.
- Installs packages
- Commits and pushes
In this repository79 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- 21st-magicSkill
- alpacaSkill
- ask-mattSkill
- autoresearchSkill
- auto-stage-commitSkill
- browser-harnessSkill
- codebase-designSkill
- codex-reviewSkill
- compact-memorySkill
- connect-recommendSkill
- connect-required-verification-informationSkill
- decision-mappingSkill
- delegate-taskSkill
- design-an-interfaceSkill
- design-mdSkill
- diagnosing-bugsSkill
- domain-modelingSkill
- edit-articleSkill
- extract-designSkill
- ffmpegSkill
- find-skillsSkill
- firecrawlSkill
- generateSkill
- git-guardrails-claude-codeSkill
- grillingSkill
- grill-me-codexSkill
- grill-meSkill
- grill-with-docs-codexSkill
- grill-with-docsSkill
- gwSkill
- handoffSkill
- implementSkill
- improve-codebase-architectureSkill
- kie-aiSkill
- lightragSkill
- llmfitSkill
- loop-meSkill
- migrate-to-shoehornSkill
- notebooklmSkill
- obsidian-vaultSkill
- openspaceSkill
- playwrightSkill
- prototypeSkill
- qaSkill
- request-refactor-planSkill
- resolving-merge-conflictsSkill
- reviewSkill
- roastSkill
- scaffold-exercisesSkill
- session-handoffSkill
- setup-matt-pocock-skillsSkill
- setup-pre-commitSkill
- site-teardownSkill
- skill-discoverySkill
- skilluiSkill
- spline-3dSkill
- stripe-appsSkill
- stripe-best-practicesSkill
- stripe-directorySkill
- The first 60 shown.
The file
Files
CodeBurn — AI Spend Analytics
See where your AI spend goes — by task, model, tool, and project, across 31 AI tools (Claude Code, Codex, Cursor, Gemini CLI, Cline, and more).
When to Use
- "How much am I spending on Claude Code?"
- "Show me my token usage breakdown"
- "Which tasks are costing the most?"
- "Am I using the right model for the job?"
- "Optimize my AI spend"
- Any cost/budget/token-usage question about AI tools
Quick Start
# Interactive dashboard (last 7 days)
npx codeburn
# Or install globally (faster)
npm install -g codeburn
codeburnCore Commands
# Dashboard views
codeburn # Interactive TUI — last 7 days (default)
codeburn today # Today's usage
codeburn month # This calendar month
# One-liner status
codeburn status # Today + month totals
codeburn status --format json # Same as JSON
# Reports
codeburn overview # Plain-text monthly summary
codeburn report -p 30days # Rolling 30-day window
codeburn report -p all # All recorded sessions
codeburn report --from 2026-04-01 --to 2026-04-30 # Date range
codeburn report --format json # Full data as JSON
# Export
codeburn export # CSV (today, 7d, 30d)
codeburn export -f json # JSON export
# Analysis
codeburn optimize # Scan for waste + copy-paste fixes (30d)
codeburn optimize -p week # Scope to last 7 days
codeburn compare # Side-by-side model comparison
# Web dashboard with charts
codeburn web # http://localhost:4747
# Filter by provider or project
codeburn report --provider claude
codeburn report --project my-appTask Categories (Auto-Classified)
| Category | What triggers it |
| Coding | Edit, Write tools |
| Debugging | Error/fix keywords + tool usage |
| Feature Dev | "add", "create", "implement" |
| 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 |
Reading the Dashboard — Key Signals
| Signal | What it might mean |
| Cache hit < 80% | System prompt or context not stable |
Lots of Read calls per session | Agent re-reading same files, missing context |
| Low 1-shot rate (Coding 30%) | Agent struggling with edits, retry loops |
| Opus dominating cost on small turns | Overpowered model for simple tasks |
| Conversation category dominant | Agent talking instead of doing |
| No MCP usage shown | Either not using MCP, or config is broken |
Claude Code Data Location
CodeBurn reads Claude Code session files from:
~/.claude/projects/<sanitized-path>/<session-id>.jsonlEach session carries: model name, token usage (input/output/cache read/cache write), tool_use blocks, timestamps. No data leaves your machine.
Multiple Claude config dirs: set CLAUDE_CONFIG_DIRS (: on POSIX, ; on Windows).
Installation
Already installed in this project. On fresh clones, setup.sh installs via:
npm install -g codeburnVerify:
codeburn --versionUpgrade
npm install -g codeburn@latest
# Or via /update-all skillSource
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

