agentleFS
RoentekRoentek/Claude_Code_Boilerplate_Framework/.claude/skills/codeburn/SKILL.md

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

The file

Files
SKILL.md

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
codeburn

Core 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-app

Task Categories (Auto-Classified)

CategoryWhat triggers it
CodingEdit, Write tools
DebuggingError/fix keywords + tool usage
Feature Dev"add", "create", "implement"
Refactoring"refactor", "rename", "simplify"
Testingpytest, vitest, jest in Bash
ExplorationRead, Grep, WebSearch without edits
PlanningEnterPlanMode, TaskCreate tools
DelegationAgent tool spawns
Git Opsgit push/commit/merge in Bash
Build/Deploynpm build, docker, pm2
Brainstorming"brainstorm", "what if", "design"
ConversationNo tools, pure text exchange
GeneralSkill tool, uncategorized

Reading the Dashboard — Key Signals

SignalWhat it might mean
Cache hit < 80%System prompt or context not stable
Lots of Read calls per sessionAgent re-reading same files, missing context
Low 1-shot rate (Coding 30%)Agent struggling with edits, retry loops
Opus dominating cost on small turnsOverpowered model for simple tasks
Conversation category dominantAgent talking instead of doing
No MCP usage shownEither not using MCP, or config is broken

Claude Code Data Location

CodeBurn reads Claude Code session files from:

~/.claude/projects/<sanitized-path>/<session-id>.jsonl

Each 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 codeburn

Verify:

codeburn --version

Upgrade

npm install -g codeburn@latest
# Or via /update-all skill

Source

https://github.com/getagentseal/codeburn

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.