tigerless-labs/cost-xray

何を解決するか

ほとんどのAIコーディングエージェントの使用ツールはローカルログを読み込むだけであり、モデルが呼び出される前に組み立てられる「目に見えない」リクエスト時のコンテキスト（システムプロンプト、ツールスキーマ、MCPブロックなど）を無視しています。cost-xrayは、実際に送信されている内容と各リクエストの特定部分のコストを正確に可視化するためのAPIトラフィックの可視化を提供します。

動作方法

mitmproxy を使用してローカルキャプチャホップとして動作します。コーディングエージェント（Claude Code や Codex など）とモデルAPIの間のHTTP/HTTPSトラフィックをインターセプトします。

• キャプチャ: Claude Code にはリバースプロキシ、Codex にはスコープ付きローカルCAを持つフォワードプロキシを使用します。
• プライバシー: すべてのデータは ~/.cost-xray/ にローカルに保存され、ディスクに記録される前にAPIキーとシークレットはマスキングされます。
• 分析: キャプチャされた生のバイトデータを、ライブリレーに遅延を加えずに、別途マテリアライザーがトークン化・価格計算します。
• 重複削除: スペースを節約するため、一意のブロック（メッセージ、スキーマ）は一度だけ保存され、繰り返しのセッション履歴には各ターンごとの差分（デルタ）を使用します。

対象ユーザー

APIコストを最適化したいAIコーディングエージェントを使用する開発者。コンテキストウィンドウに無駄な部分（使用されていないMCPサーバーなど）があるかを特定し、コンテキストウィンドウの実際の構成を理解したい人向けです。

主な特徴

• 細分化されたコスト追跡: セッション全体の合計ではなく、個々のツール呼び出しや特定のソースごとのコストを追跡します。
• コンテキストウィンドウの可視化: コンテキストウィンドウを占めている内容（システムプロンプト、ツールスキーマなど）を正確に表示します。
• 無駄の検出: 各リクエストに注入されるが実際に使われない設定されたMCPサーバーやツールを警告します。
• トークン化の正確性: Claudeのプライベートトークナイザーに校正された推定器を使用し、請求額を正確に再現します。
• 自己修復キャプチャ: プロキシが停止しても、プロキシの再起動または直接実行によりエージェントが継続して動作するようラッパーが保証します。
• TUIダッシュボード: エージェント → プロジェクト → セッション → 特定のAPI呼び出しへと段階的に掘り下げるライブターミナルUIを提供します。