AI 编码工具 Token 用量与成本可观测性仪表盘，支持 18 种工具的无侵入式会话读取，提供成本追踪、效率度量与浪费检测。
核心定位#
CodeBurn 是一款面向 AI 编码工具的纯本地 Token 用量与成本可观测性仪表盘。当开发者同时使用多种 AI 编码工具时，token 消耗与实际产出之间缺乏透明关联。CodeBurn 直接从本地磁盘读取各工具的会话日志/数据库，零侵入、零配置即可获得全量成本数据。仅做"读取 + 分析 + 展示"，不拦截、不代理、不修改任何 AI 工具行为。
会话数据采集#
覆盖 18 种 AI 编码工具：Claude Code、Claude Desktop、Codex (OpenAI)、Cursor（SQLite 数据库读取）、cursor-agent、Gemini CLI、GitHub Copilot（CLI + VS Code workspaceStorage）、Kiro、OpenCode、OpenClaw、Pi、OMP、Droid、Roo Code、KiloCode、Qwen、Goose、Antigravity。纯本地磁盘读取，无需 wrapper/proxy/API key。
成本计算引擎#
基于 LiteLLM 模型价格数据，本地缓存 24 小时。分项计算 input / output / cache read / cache write / web search token 成本，支持 Claude Fast Mode 乘数，内置硬编码回退定价防止模糊匹配错误。
效率度量#
- One-Shot Rate：检测 Edit/Bash/Edit 重试模式，统计编辑一次成功率
- Yield 产出关联：将 AI 会话与 git commit 按时间戳关联，分类为 Productive / Reverted / Abandoned
- 任务分类：13 类纯确定性分类（Coding, Debugging, Feature Dev, Refactoring, Testing, Exploration, Planning, Delegation, Git Ops, Build/Deploy, Brainstorming, Conversation, General），无 LLM 调用
浪费检测（Optimize）#
扫描会话和 ~/.claude/ 配置，识别跨会话重复文件读取、低 Read:Edit 比率、未使用的 MCP server 开销、膨胀的 CLAUDE.md、幽灵 agents/skills/slash commands。输出 A-F 健康评级 + 可粘贴修复建议。
模型对比（Compare）#
交互式面板，对比 one-shot rate、retry rate、self-correction、cost per call、cache hit rate 等指标。
预算与国际化#
订阅计划追踪：Claude Pro/Max、Cursor Pro 预设 + 自定义月度预算，仪表盘进度条。支持 162 种 ISO 4217 货币，汇率来自 Frankfurter（欧洲央行数据）。
桌面集成与数据导出#
macOS Menu Bar 常驻应用（codeburn menubar），Linux 桌面集成（gnome/ 目录）。--format json 支持所有报告命令便于管道处理，codeburn export 支持 CSV 导出。
架构概要#
TypeScript ESM 模块，tsup 打包，Commander.js CLI 框架，Ink（终端 React 渲染）+ React 19，Vitest 测试。Provider 架构为单文件设计（如 src/providers/codex.ts），易于扩展。集成 Semgrep 安全规则。源码结构：src/（核心）、tests/、scripts/、mac/（菜单栏应用）、gnome/（Linux 桌面）。
安装与使用#
前置条件：Node.js ≥ 22.20（macOS / Linux / Windows），至少一个支持的 AI 编码工具在本地有会话数据。
npm install -g codeburn
brew tap getagentseal/codeburn && brew install codeburn
npx codeburn
核心命令：codeburn（交互式仪表盘）、codeburn today/month、codeburn report -p 30days、codeburn status、codeburn optimize、codeburn compare、codeburn yield、codeburn export、codeburn plan set claude-max、codeburn currency GBP。配置文件：~/.config/codeburn/config.json。
待确认信息#
- NPM 包确切地址（README 提供安装命令但未直接链接 npmjs.com 页面）
- AgentSeal 组织背景有限（仅有邮箱 hello@agentseal.org），无独立官网
- Menu Bar 应用未说明代码签名与公证状态
- 当前版本 0.9.7，尚未达到 1.0，CLI 接口可能有破坏性变动
- Cursor SQLite 读取格式的长期兼容性待观察