你是否好奇过——当Claude或Codex这类AI编程助手为你改代码时,它到底“看”了哪些文件?在修改前翻了多少文档?在哪几处反复停留、犹豫、试探?mindwalk 就是这样一款独一无二的可视化工具:它不分析代码逻辑,也不生成新功能,而是把每一次AI编码会话(session)变成一场可回放的「代码探索之旅」——在你本地仓库生成的3D星图上,用光迹实时还原AI的阅读路径、搜索焦点与编辑决策。它解决的不是“怎么写对”,而是“它怎么想明白”的透明化难题。
核心功能
- 3D代码宇宙可视化:自动将整个代码库渲染为沉浸式三维空间地图,目录结构即星系,文件即星球,深度嵌套关系一目了然
- 会话轨迹动态回放:支持Claude Code和Codex标准JSONL日志格式,以光流形式精准呈现AI“读→查→思→改”的完整动线
- 全本地离线运行:所有解析、渲染、回放均在你的机器完成,原始session数据绝不上传——隐私零泄露,合规有保障
- 智能高亮关键行为:不同颜色区分“文件读取”“符号搜索”“代码编辑”等操作类型,停留时长自动影响光效强度,直观暴露AI的认知重心
- 一键启动零配置:默认自动扫描
~/.claude/projects和~/.codex/sessions目录,开箱即用,无需手动指定路径或日志文件 - 轻量单二进制部署:仅一个Go编译后的可执行文件(
mindwalk),无依赖、无服务端、无后台进程,彻底告别环境折腾
适合哪些人用
如果你是AI编程实践者(如用Claude/Codex辅助开发)、团队技术负责人(需评估AI工具的实际覆盖范围与盲区)、教育者或学习者(想理解优秀AI如何拆解复杂任务),或是代码审计与质量工程师(需验证AI修改是否超出预期边界)——mindwalk 都是你不可或缺的“认知显微镜”。它不替代IDE,但能让你第一次真正“看见”AI大脑里的代码世界地图。
快速上手
只需三步,30秒启动:
- 终端运行安装命令:
curl -fsSL https://raw.githubusercontent.com/cosmtrek/mindwalk/master/scripts/install.sh | sh - 将安装路径加入环境变量:
export PATH="$HOME/.local/bin:$PATH"(建议写入~/.bashrc或~/.zshrc) - 直接执行:
mindwalk,浏览器将自动打开可视化界面(默认地址http://localhost:8080)
Windows用户可前往GitHub Releases页面下载预编译zip包;开发者亦可通过make setup && make build从源码构建。
项目信息
A visualization tool that replays coding-agent sessions on a 3D map of your codebase.
517
Stars
29
Forks
Go
MIT
编程语言:Go|Star 数:517(截至2024年)|开源协议:MIT|GitHub 项目地址
当你开始信任AI写代码,更该学会看清它“为什么这么写”——mindwalk,让每一次AI协作都变得可追溯、可理解、可进化。



