cosmtrek/mindwalk

何を解決するか

Mindwalkは、コーディングエージェントからの生の線形ログを、コードベースの視覚的3Dマップに変換します。エージェントがリポジトリをどのように探索・変更したかを理解するという課題を解決します——どのファイルが関連していたか、どこを彷徨ったか、その足跡が意図された範囲と一致していたか——これらはJSONLログを読むだけでは把握しづらいものです。

動作方法

Mindwalkはリポジトリの決定論的な「シティマップ」を作成し、エージェントのセッションの再生を重ねます。Claude Code、Codex、piなどの異なるエージェントからのログを正規化するアダプタを使用して、ファイルに触れたイベントのストリームに変換します。

主な視覚要素は以下の通りです：

• 地形とツリー表示：コードベースはラジアルツリーまたはトレーマップとしてレンダリングされ、輝きの強さでファイルが触れた頻度を示します。
• タッチ状態：ファイルは最も深いインタラクションの種類で色分けされます（例：モスグリーン＝閲覧済み、ムーンライトブルー＝読み取り、ウォームアンバー＝編集済み）。
• 再生デッキ：タイムラインにより、セッションをスクロール可能。観察（クールカラー）と変更（ウォームカラー）を区別できます。
• エージェントレンズ：セッションにサブエージェントが含まれる場合、ユーザーは「レンズ」を切り替えて、同じマップ上で特定のサブエージェントのトレースを再生できます。
• セッション評価：オプション機能として、ローカルエージェントCLIを使用して、プロセスの次元（探索、範囲、彷徨い、検証）に基づきセッションの軌道を評価し、タスク固有のスコアカードを提供します。

対象ユーザー

コードベースとのインタラクションを可視化することで、コーディングエージェントのデバッグ、分析、評価が必要な開発者やAIエージェント研究者。

特徴

• 3Dコードベース可視化：エージェントの活動をリポジトリの3Dマップを通過する光として可視化。
• ローカルファースト：GoバイナリとUIはローカルで実行。セッションの閲覧は外部にデータを送信しません。
• マルチエージェント対応：Claude Code、Codex、piからのログをサポート。
• サブエージェント用レンズ：複雑なセッション内のサブエージェントトレースを分離・再生可能。
• 証拠に基づく評価：タイムラインイベントと直接リンクするLLMベースのセッションレポート。
• クライアントサイド動画エクスポート：ブラウザ内で完全に実行され、再生セッションを.webmファイルとしてエクスポート可能。