stormzhang/token-tracker

何を解決するか

Token Trackerは、Claude Code、Codex、Kimi Codeといった複数のローカルAIエージェントにおけるトークン消費量とコストを統合的に監視・分析する手段を提供します。使用データが分散している問題を解決し、コスト、クォータ、セッション詳細を1つのダッシュボードに集約することで、『請求額の驚き』を防ぎ、リアルタイムでクォータ制限を追跡できます。

動作方法

このツールは、エージェントの設定ディレクトリ内のローカルセッションログ（JSONLおよびSQLiteファイル）を読み取り専用で読み込みます。Claude CodeおよびKimi Codeの公式StatusLine APIを介してエージェントのインターフェースに直接統合するか、Codex用のカスタム「擬似ステータスライン」フックを使用してリアルタイムメトリクスを表示します。また、CLIによるレポート生成機能と、ローカルFIFOおよびターミナル自動化（iTerm2/Ghostty用AppleScript）を活用したサイドバーユーティリティも備えており、アクティブなセッションのライブ概要を提供します。

対象ユーザー

複数のAIコーディングエージェント（Claude Code、Codex、Kimi Code）を使用し、手動で複数のプラットフォームを確認せずにトークン使用量、金銭的コスト、残りのAPI/サブスクリプションクォータを追跡したい開発者およびパワーユーザー。

特徴

• 統合追跡: Claude Code、Codex、Kimi Codeのデータを1か所に集約。
• リアルタイムステータスバー: エージェントのターミナルインターフェースにリアルタイムのトークン、コスト、クォータメトリクスを直接挿入。
• 多次元レポート: 1日単位のヒートマップ、週次・月次レポートを生成し、コストとトークン分析を実施。
• インタラクティブサイドバー: アクティブなすべてのセッション、ステータスランプ、およびワンクリックで特定のターミナルペインに移動できる「次にすべきこと」の提案を表示する常駐パネル。
• ゼロ設定: インストールされたエージェントを自動検出し、APIキーもクラウドアップロードも不要でローカルデータを読み込み。
• プライバシー最優先: すべてのデータはローカルに保存・処理されます。