delexw/claude-code-trace

解決する課題

Claude Code はセッション履歴を ~/.claude/projects/ に生の JSONL ファイルとして保存します。これは人間が読みやすく分析するのは困難です。Claude Code Trace は、これらのログをリアルタイムで閲覧・検索・監視できるユーザーフレンドリーなインターフェースを提供し、生データを読みやすい会話形式に変換します。

動作方法

このツールはローカルの JSONL セッションファイルを読み取り、インタラクティブな会話としてレンダリングします。GUI デスクトップアプリ（Tauri で構築）、Web アプリ、およびターミナルユーザーインターフェース（TUI）の3つの異なるインターフェースをサポートしています。また、Jev（TypeSafe AI の System One Model）と統合され、エージェントのトレースに対して行動分析を実行し、ツール使用、集中度、回復力などの効率指標をスコアリングします。

対象ユーザー

長時間実行されるワークフローのデバッグが必要な、またはツールや MCP（Model Context Protocol）呼び出しを検査、AI エージェントの行動効率を分析したい開発者。

主な特徴

• マルチインターフェース対応：デスクトップアプリ、Web アプリ、TUI のいずれでも利用可能。
• ライブ尾追：実行中の Claude Code セッションをリアルタイムで監視可能。
• Jev 統合：型安全な確率を使用してエージェントの効率を分析し、フラッシングや非効率なトークン使用を特定。
• MCP 対応：Model Context Protocol のツール呼び出しを自動検出し、人間が理解しやすい名前で表示。
• プライバシー重視：外部の Jev 分析に送信する前にペイロードをマスキングし、明示的な承認を必要とする。
• クロスプラットフォーム：macOS、Linux、Windows 用のネイティブビルドを提供。