このプロジェクトについて

cctraceは、ローカルで動作するゼロ設定のTLS傍受型プロキシで、コーディングエージェント(Claude Code、OpenAI Codex CLI、Grok CLI、Kimi Code CLI、opencode)とそれぞれのAPIの間に位置し、すべてのHTTP呼び出しをリアルタイムでキャプチャします。チャットエンドポイントのみを参照するベースURLプロキシとは異なり、cctraceはトランスポート層で傍受し、OAuthフロー、使用量/クレジットエンドポイント、MCPレジストリ呼び出し、ブートストラップリクエスト、テレメトリを捕捉します。これらは単純なURL書き換えでは観測できません。 このツールはCA証明書を自動生成し、HTTPS_PROXYを介してエージェントを経由するよう設定するため、手動設定は不要です。ファーストパーティのホストは復号化され完全にキャプチャされます。外部ホスト(npm、GitHub、apt)は不透明なバイトカウントトンネルとして通過し、トレースを軽量に保ちます。 ライブWeb UIは、フィルターチップ付きのカテゴリ別リクエストビュー、デコードされたSSEストリーム、推論努力とプロンプトキャッシュの判定、ファーストトークン遅延、リクエストごとの推定コストを提供します。セッションは人間が数える方法で再構築され、時間経過に伴うレーンを示す軌跡バー、タッチされたファイルを命名するツール行、サブエージェントブランチ、モデルエポック、コンパクション境界を表示します。セッション再生は、キャプチャされた任意のセッションをステップ実行または再生し、アクティブな実行中はライブテーリングを提供します。 コンテキストビューは、時間経過に伴うエージェントのウィンドウをインタラクティブな概要で表示します。ワイヤリクエストごとの積み上げ列は6つのコンテキストカテゴリで色分けされ、コンパクションマーカー、ウォールクロック内訳が含まれます。選択は3つの方法で読み取れます:コンテキストグラフ(氷柱分解)、線形レコードストリーム、または注入とコンパクションのイベントタイムラインとして。 コスト追跡は、クォータの使用先をキャッシュ読み取り/書き込み/入力/出力の内訳で示し、キャッシュミスを原因(TTL期限切れ、プレフィックス変更、529リトライ)とともに特定し、クライアントがポーリングするアカウントクォータを表示します。insightsコマンドは、日次、プロジェクト、クライアント別に実行を集計し、キャッシュ分割とクォータパーセンテージのオプションの深いスキャンを提供します。 doctorコマンドは、セッションの最新リクエストウィンドウを診断し、未使用のツールスキーマ、繰り返し発生するハーネス注入、重複コンテンツ、キャッシュ非効率を、実行可能なレバーとともに特定します。 トレースは.jsonlファイルとして保存され(.jsonl.zstにアーカイブ)、cctrace viewでいつでも再オープンでき、マークダウントランスクリプトまたはオフラインHTMLスナップショットとしてエクスポート可能です。クロスプロジェクトダッシュボードは、すべてのライブおよび完了した実行を、ワンクリックセッションビュー、停止コントロール、ストレージ管理とともに表示します。 資格情報は、ディスクに書き込まれる前にヘッダー、ボディ、URLから削除されます。トレースはプロジェクトツリー外の~/.local/share/cctrace/に保存されます。このツールはBun、openssl、およびターゲットCLIを必要とし、npmまたはスタンドアロンコンパイルバイナリとして利用可能です。