TL;DR

CodeBurn là công cụ TUI mã nguồn mở (MIT, ~3.5k sao GitHub) cho phép bạn nhìn chính xác token AI coding của mình đi đâu — theo task, tool, model và project. Nó đọc thẳng session files từ đĩa, không cần proxy, wrapper hay API key. Hỗ trợ 8 provider: Claude Code, Claude Desktop, Codex, Cursor, OpenCode, Pi, OMP và GitHub Copilot. Cài 1 lệnh: npm i -g codeburn.

CodeBurn TUI dashboard hiển thị chi phí token theo project, model và task

Có gì mới

CodeBurn được Camille Roux chia sẻ lên X và lan nhanh trong cộng đồng AI coding. Bản mới nhất là Menubar v0.8.9 (2026-04-22). Điểm khác biệt so với các công cụ đo lường khác: zero-config retroactive analytics. Bạn không phải bật log từ đầu — CodeBurn đọc ngược session đã lưu trên máy, dựng ra dashboard ngay lập tức.

  • Interactive TUI với gradient charts, responsive panels, điều hướng bằng phím.
  • 13 nhóm task phân loại tự động: Coding, Debugging, Feature Dev, Refactoring, Testing, Exploration, Planning, Delegation, Git Ops, Build/Deploy, Brainstorming, Conversation, General.
  • Native macOS menubar app (Swift, chiếm 26.1% codebase) với live refresh qua FSEvents.
  • Compare mode so sánh side-by-side: one-shot rate, retry rate, cost/call, cost/edit, cache hit %.
  • Optimize scanner tìm waste patterns, chấm điểm A–F theo độ "khoẻ" của cách bạn dùng AI.

Tại sao nó quan trọng

Bill tháng Claude Max 200 USD, Cursor Pro, subscription Codex — nhưng hỏi bạn "tháng này tốn nhiều nhất ở project nào, task gì, model nào?" thì gần như không ai trả lời chính xác được. Vendor dashboard chỉ cho bạn tổng số token. CodeBurn đi xa hơn: nó biết lần debug vừa rồi bạn burn 12k token cho một cái typo, hay refactor một file mà Claude phải retry 4 lần trước khi đúng.

Quan trọng nhất: CodeBurn xuất metric one-shot success rate theo từng loại task. Đây là chỉ số mà chưa vendor nào expose — nó cho bạn biết model nào "làm đúng ngay lần đầu" vs model nào ngốn token vào vòng lặp edit-test-fix.

Chi tiết kỹ thuật

Hạng mụcChi tiết
Provider hỗ trợClaude Code, Claude Desktop, Codex, Cursor, cursor-agent, OpenCode, Pi, OMP, GitHub Copilot (output tokens only). Amp — planned.
Pricing sourceLiteLLM model database, cache 24h tại ~/.cache/codeburn/. Hỗ trợ input, output, cache write/read, web-search cost.
Exchange ratesFrankfurter (ECB), 162 ISO 4217 currency, miễn phí, không cần auth.
Task categories13 nhóm deterministic (phân loại bằng rule, không phải LLM).
Auto-refreshTUI mặc định 30s từ v0.8.0, có thể chỉnh qua --refresh 60.
Test coverage274 tests.
StackTypeScript 73.4% + Swift 26.1% (menubar app).

Nơi CodeBurn đọc session

  • Claude Code → ~/.claude/projects/ (JSONL)
  • Cursor → ~/Library/Application Support/Cursor/User/globalStorage/state.vscdb (SQLite)
  • Codex → ~/.codex/sessions/ (JSONL)
  • OpenCode → ~/.local/share/opencode/ (SQLite)
  • Pi / OMP → ~/.pi/agent/sessions/ hoặc ~/.omp/agent/sessions/

Use cases thực tế

codeburn optimize — phân tích waste pattern và gợi ý fix copy-paste

  • Indie dev trên Claude Max / Cursor Pro: biết chính xác còn bao nhiêu quota trước khi hit limit.
  • Engineering manager: allocate budget AI per project, xem top-5 session đắt nhất.
  • Chọn model: so sánh Sonnet vs Haiku vs GPT-5 one-shot rate theo từng task type — debugging thì model A, refactoring thì model B.
  • Săn lãng phí: codeburn optimize spot ra các pattern như file bị re-read nhiều lần qua các session, tỉ lệ Read:Edit thấp, bash output không cap (BASH_MAX_OUTPUT_LENGTH), MCP server không dùng, CLAUDE.md phình to kèm @-import expansion, junk directory reads.
  • Ops dashboard: codeburn report --format json --refresh 60 làm JSON feed; export CSV multi-period (today / 7 days / 30 days).

Các lệnh CLI chính

codeburn                      # dashboard tương tác (default 7 ngày)
codeburn today | month        # snapshot nhanh
codeburn report --from 2026-04-01 --to 2026-04-10
codeburn status               # one-liner today + month
codeburn optimize -p week     # quét waste
codeburn compare -p week      # so sánh model
codeburn menubar              # cài macOS menubar widget

Giới hạn & pricing

CodeBurn miễn phí, MIT license. Nhưng có vài caveat đáng nhớ:

  • GitHub Copilot chỉ track output tokens — Copilot không expose full billing qua session file.
  • Cursor "Auto" mode chỉ là estimate — code dùng Sonnet pricing làm proxy vì Cursor không ghi model cụ thể.
  • Menubar widget là macOS-only (Swift). Linux/Windows user chỉ có TUI.
  • Cần session directory tồn tại local — không hoạt động cho workflow cloud-only.
  • Subscription plan tracking (Claude Pro/Max, Cursor Pro) phải config thủ công qua codeburn plan set.

CodeBurn macOS menubar widget hiển thị cost theo agent và period

Kế tiếp là gì

Roadmap công khai có Amp provider support (planned). Vòng release đang nhanh: từ 0.8.0 (19/04) lên 0.8.9 (22/04) trong 3 ngày, kèm fix OOM trên session file lớn, MiniMax pricing, model-alias command, patch prototype-pollution. Nếu bạn đang chi hàng trăm USD/tháng cho AI coding mà chưa nhìn thấy token đi đâu, npx codeburn là lệnh đáng chạy tối nay.

Nguồn: github.com/AgentSeal/codeburn, CHANGELOG, @CamilleRoux.