Tool ★ 489

CodeBurn

AgentSeal/codeburn →
#tokens#cost#usage#dashboard#TUI

Updated

💡

An interactive TUI dashboard for Claude Code token usage and cost. 13 auto-categorized task types and one-shot success rate tracking.

✨
Visual token usage analytics Experience
Installation · npx
npx (no install) $ npx codeburn
Global install $ npm install -g codeburn

What it does

CodeBurn is an interactive TUI dashboard for Claude Code usage. Instead of reading a plain text table, you get gradient charts, keyboard navigation, and an at-a-glance view of where your tokens are going — plus automatic categorization of tasks into 13 buckets and a one-shot success rate metric.

CodeBurn dashboard

Features

  • Interactive dashboard — gradient charts + keyboard navigation for visual exploration
  • 13 task categories — coding, debugging, testing, refactoring, brainstorming, and more — auto-classified
  • One-shot success rate — detects edit → test → edit cycles to measure AI accuracy
  • Multi-model support — unified tracking across Claude (Opus/Sonnet/Haiku), GPT-4o, Gemini
  • macOS menu-bar widget — SwiftBar plugin for menu-bar token monitoring
  • Data export — CSV and JSON reports

Usage

codeburn           # interactive dashboard (default: 7 days)
codeburn today     # today's usage
codeburn month     # this month's usage
codeburn status    # one-line summary
codeburn export    # generate a report

Notes

  • No API key — reads local JSONL session files from ~/.claude/projects/ directly.
  • Deterministic classification — task categorization runs without LLM calls, so no extra cost.
  • Requires Node.js 20 or later.
  • Overlaps with ccusage but focuses on interactive visualization and task classification.
  • MIT licensed.

Frequently Asked Questions

What is CodeBurn?

An interactive TUI dashboard for Claude Code token usage and cost. It uses gradient charts and keyboard navigation, automatically classifies work into 13 task categories, and tracks one-shot success rate.

Where does it run?

Wherever you use Claude Code. Requires Node.js 20+.

How do I install it?

Run `npx codeburn` (no install) or `npm install -g codeburn` for a global install.

Does it need an API key?

No. It reads local JSONL session files from `~/.claude/projects/` directly. Task classification is deterministic — no extra LLM calls and no extra cost.

How is it different from ccusage?

ccusage focuses on tabular usage and cost analytics. CodeBurn focuses on interactive visualization, 13-category task auto-classification, and one-shot success rate measurement.

What's the license?

MIT licensed.