agenttrail是一个本地开源工具，专门监控Claude Code、Codex、Cursor这些AI编程Agent干活时的状态。
启动只需要一条命令：npx agenttrail --open。
不需要注册账号，不需要全局安装，也不会向任何服务器上传数据。
它只监听本机，所有界面都跑在localhost上。
原理是把Agent嘴上说的计划和实际改动的文件对照着看。
Agent说在做A组件，文件却一直在动B组件，地图上立刻就能看出问题。
已经标记完成的任务如果文件又被改动，卡片会重新亮灯提醒你。
界面上会画出一张5到9个真实组件的依赖关系图，每个组件标注进行中、已完成还是卡住。
状态符号也很直观，[x]代表已完成，[~]代表进行中，[!]代表卡住了。
整个程序核心是一个470行的零依赖Node文件，界面是单个静态HTML，连数据库都没有。
项目在7.8万文件的大仓库上实测过，读取文件树做了分层限制，不会卡死。
多个仓库可以同时监控，每个仓库一个后台进程，用标签页切换。
它只负责观察，绝不会给Agent发指令或修改你的代码。
执行init命令后，Agent会在PLAN.md里自动维护这张项目地图。
MIT协议，完全开源免费。
github agent