CodeBurn: AIコーディングのトークンとコストを追跡するローカルファーストツール

AIコーディング支出のためのローカルファーストトラッカー | getagentseal/codeburn

CodeBurnは、Claude Code、Cursor、Codex、Gemini、Grokなどを含む36のツールとエージェントにわたるAIコーディングのトークン使用量とコストを追跡する、無料でオープンソースのローカルファーストツールです。これらのツールがすでにディスクに書き込むセッションファイルを読み取り、すべてのトークンとドルをタスク、モデル、ツール、プロジェクトごとに分解します。ラッパーもプロキシもAPIキーも不要で、マシンからデータが外部に出ることはありません。価格はLiteLLMから取得され、毎日更新されます。READMEには、ターミナルダッシュボード、ウェブダッシュボード、macOSメニューバーアプリ、デスクトップアプリの4つのインターフェースが示されており、すべてがディスク上の同じセッションファイルを読み取ると主張されています。

クイックスタートとコマンドインターフェース | getagentseal/codeburn

CodeBurnを実行する最も速い方法は`npx codeburn`で、デフォルトで過去7日間のインタラクティブなダッシュボードが開きます。矢印キーで期間を切り替え、`q`で終了します。永続的なコマンドとして`npm install -g codeburn`でグローバルインストールでき、`bunx codeburn`や`pnpm dlx codeburn`も使用可能です。macOSでは`brew install codeburn`も選択肢です。Node.js 22.13以上が必要で、ディスクにセッションデータを持つサポート対象ツールが少なくとも1つ必要です。macOS用メニューバーアプリは`codeburn menubar`で起動し、LinuxではGNOME Shell拡張機能が同様のパネルビューを提供します。READMEにはmacOS、Windows、Linux向けのデスクトップアプリのダウンロードリンクも記載されていますが、デスクトップビルドの具体的なセットアップ手順はダウンロードリンク以外には記述されていません。

最適化と実行：無駄の発見と修正 | getagentseal/codeburn

`codeburn optimize`コマンドは、セッションと`~/.claude/`設定をスキャンして無駄のパターンを探します：セッション間で再読込されるファイル、読み取りと編集の比率が低い、制限なしのbash出力、未使用のMCPサーバー、ゴーストエージェントとスキル、肥大化した`CLAUDE.md`ファイル、キャッシュ作成のオーバーヘッド、コンテキストが重いセッション、編集やリトライのない高コストなセッションなどです。各発見には推定トークンとドルの節約額、および貼り付け可能な修正案が含まれ、緊急度でランク付けされ、AからFまでのセットアップヘルスグレードが付けられます。繰り返し実行すると、48時間のウィンドウに対して発見が新規、改善中、解決済みに分類されます。`--apply`フラグは設定クラスの修正を対話的に適用し、`--dry-run`でプレビュー、`--yes`で全部適用します。すべての変更は適用前にバックアップされジャーナルに記録され、`codeburn act list`、`codeburn act undo`、`codeburn act report`で履歴を追跡し、変更をロールバックし、3日後に実際の節約額と推定値を比較します。

Claude Codeの予算ガード | getagentseal/codeburn

CodeBurnは、作業中にセッションコストを監視するオプトインフックをClaude Codeにインストールできます。`codeburn guard install`は、これらのフックをプロジェクトの`.claude/settings.json`またはグローバルの`~/.claude/settings.json`に追加します。ソフトキャップ（デフォルト5ドル）は一度だけ警告を表示し、ハードキャップ（デフォルト15ドル）はセッションを停止し、`codeburn guard allow`でそのセッションのみ解除できます。チェックポイント（デフォルト3ドル）は、編集やコミットなしでセッションが終了した場合に新しく始めるよう促します。キャップは`~/.config/codeburn/guard.json`で編集し、`--statusline`でClaude Codeのステータス行にセッションコストを表示します。インストールは他の変更と同じジャーナルを通るため、`codeburn act undo`でも削除できます。フックはフェイルオープン設計で、壊れたガードがセッションをブロックすることはありません。

モデル比較と成果の追跡 | getagentseal/codeburn

`codeburn compare`はインタラクティブなモデルピッカーを開き、ワンショット率、リトライ率、自己修正、呼び出しあたりのコスト、編集あたりのコスト、呼び出しあたりの出力トークン数、キャッシュヒット率に加えて、カテゴリ別のワンショット率、委任率、計画率、ターンあたりの平均ツール数、高速モード使用量を比較します。`codeburn yield`はAIセッションをタイムスタンプでgitコミットと関連付け、支出をproductive、reverted、abandoned、ambiguousに分類します。帰属はヒューリスティックです：各コミットは最大1つのセッション、それを含む最も狭いウィンドウにクレジットされ、JSONレポートには`methodology: "timestamp-window"`が含まれます。yieldにはgitリポジトリが必要で、プロジェクトディレクトリから実行します。

ウェブダッシュボード、メニューバー、MCP、デバイス共有 | getagentseal/codeburn

`codeburn web`はhttp://localhost:4747でローカルブラウザダッシュボードを起動し、ターミナルUIと同じ内訳に加えてチャートを提供します。サーバーはlocalhostにバインドされ、何もアップロードされません。`codeburn menubar`はネイティブmacOSメニューバーアプリをダウンロードしてインストールし、メニューバーに支出を表示します。期間選択、コンパクトモード、設定可能な更新頻度があります。READMEは同じ目的のLinux GNOME拡張機能も説明しています。`codeburn mcp`はstdio上でローカルMCPサーバーを実行し、`get_usage`と`get_savings`ツールを公開します。プロジェクト名はデフォルトで仮名化されます。デバイス間で使用量を統合するには、`codeburn share --pair`がペアリング用PINを出力し、`codeburn devices`が統合合計を表示します。プレビュー版の`codeburn sync`コマンドは、チームテレメトリのために使用量をリモートエンドポイントにプッシュします。トークン数、コスト、モデル、プロジェクトを送信しますが、プロンプトやコードは送信しません。プロトコルはリリース間で変更される可能性があります。

データの読み取り方法と追跡内容 | getagentseal/codeburn

CodeBurnは、サポートされている各ツールからセッションファイルとデータベースを読み取ります。Claude Codeでは`~/.claude/projects/<sanitized-path>/<session-id>.jsonl`を読み取り、Codexでは`~/.codex/sessions/`のJSONLロールアウトファイルを読み取り、CursorはSQLiteデータベース`state.vscdb`を使用し、OpenCodeはSQLiteまたはファイルベースのストレージを使用し、Gemini CLIはセッションごとに1つのJSONファイルを書き込みます。他の多くのプロバイダーにはそれぞれ文書化されたパスがあります。一部のプロバイダーでは、トークン数はコンテンツ長や他のヒューリスティックから推定され、READMEはこれらの数値を推定値としてマークしています。価格はLiteLLMから取得され、ローカルに24時間キャッシュされ、ClaudeおよびGPT-5モデル用のハードコードされたフォールバックがあります。CodeBurnはまた、13の決定的なタスクカテゴリ、ファイル認識型リトライサイクルに基づくワンショット率、プラン、通貨変換、モデルエイリアス、価格上書き、ローカルモデル節約を追跡します。`codeburn doctor`はオフラインで読み取り専用のプロバイダー検出を診断し、JSON出力も利用可能です。

編集部の結論

CodeBurnはMITライセンスで、ローカルのセッションファイルを読み取ってAIコーディング支出の内訳を生成します。ターミナルダッシュボード、ウェブダッシュボード、macOSメニューバーアプリ、デスクトップビルドに加え、無駄の分析、予算ガード、モデル比較、gitベースの成果追跡のためのコマンドを提供します。READMEには具体的なパフォーマンスベンチマークや本番結果の記述はありません。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes