cosmtrek/mindwalk

解决的问题

Mindwalk 将编码代理生成的原始线性会话日志转换为代码库的视觉化 3D 地图。它解决了理解代理如何探索和修改仓库的问题——识别哪些文件相关，它在何处徘徊，其足迹是否符合预期范围——这些信息仅从阅读 JSONL 日志中难以察觉。

工作原理

Mindwalk 创建仓库的确定性「城市地图」，并叠加代理会话的回放。它使用适配器将不同代理（如 Claude Code、Codex 和 pi）的日志标准化为文件接触事件流。

关键视觉元素包括：

• 地形与树状视图：代码库以径向树或树状图形式渲染，光亮强度表示文件被接触的频率。
• 接触状态：文件根据其最深的交互状态着色（例如，苔藓绿表示已查看，月光蓝表示已读，暖琥珀色表示已编辑）。
• 播放控制面板：时间轴允许用户浏览会话，区分观察（冷色调）与修改（暖色调）。
• 代理透镜：如果会话涉及子代理，用户可以切换「透镜」，在相同地图上回放特定子代理的轨迹。
• 会话评估：可选功能，使用本地代理 CLI 根据过程维度（探索、范围、徘徊、验证）和任务特定评分卡，评估会话的轨迹。

适用人群

需要通过可视化代理与代码库的交互来调试、分析和评估编码代理性能的开发者和 AI 代理研究人员。

主要亮点

• 3D 代码库可视化：将代理活动可视化为光在仓库 3D 地图中移动。
• 本地优先：Go 二进制文件和 UI 在本地运行；查看会话不会将数据发送到外部。
• 多代理支持：支持 Claude Code、Codex 和 pi 的日志。
• 子代理透镜：能够隔离并回放复杂会话中的子代理轨迹。
• 基于证据的评估：LLM 生成的会话报告，将发现直接链接到时间轴事件。
• 客户端视频导出：在浏览器中完全实现，可将播放会话导出为 .webm 文件。