agenttrail 是什么?本地观测 AI 编程代理的可视化工具

中文导读

agenttrail 是开源项目,站内分类为 AI 智能体。简介:本地观测 AI 编程代理的可视化工具。项目说明中列出的主要功能包括:Agenttrail Map：展示项目结构、依赖关系、文件活动和会话轨迹；Agenttrail Kitchen：以 3D 厨房场景可视化任务、角色贡献和完成情况；自动读取本地 Codex 和 Claude Code 会话日志，无需 API key。适合使用 Codex、Claude Code 等 AI 编程代理的开发者，希望在本地直观了解代理正在改哪些文件、推进哪些任务。

根据 GitHub 公开数据,该项目的编程语言为 JavaScript,开源协议为 MIT,创建于 2026-08-21,最近更新于 2026-09-09,目前有 898 个 Star。

项目介绍

Agenttrail 是一个面向 AI 编程代理的本地可观测性工具，它观察本地文件、计划以及受支持的代理事件，把代理的工作过程转化为实时视图。它本身不运行代理、不分配任务，也不判断任务是否完成，只是把证据可视化出来。

项目包含两个独立视图：Agenttrail Map 关注项目结构、进度和哪些组件正在变化，主要读取 PLAN.md、文件变更和可选的 Claude Code hooks；Agenttrail Kitchen 关注当前任务、角色贡献和已完成的工作，用厨师、订单、烹饪和配送的 3D 场景来呈现，数据来自原生 todo、本地 Codex/Claude 活动以及可选的 Claude/Cursor hooks。两者各自在浏览器中运行，目前使用独立的本地服务和适配器。

主要功能

• Agenttrail Map：展示项目结构、依赖关系、文件活动和会话轨迹
• Agenttrail Kitchen：以 3D 厨房场景可视化任务、角色贡献和完成情况
• 自动读取本地 Codex 和 Claude Code 会话日志，无需 API key
• 支持通过可选 hooks 接入 Claude Code 和 Cursor 代理
• 提供 --example 脚本化示例，可在连接代理前预览效果
• 本地优先，观察过程不启动代理、不修改仓库

适合谁用

适合使用 Codex、Claude Code 等 AI 编程代理的开发者，希望在本地直观了解代理正在改哪些文件、推进哪些任务。

快速上手

1. 确保已安装 Node.js 20+，并准备一个本地项目文件夹
2. 在要观察的仓库中运行：npx agenttrail-kitchen .
3. 浏览器打开 localhost:4780（或下一个空闲端口），保持终端开启并继续使用编程代理
4. 想先看效果可加 --example 参数，然后点击 Next example step
5. 运行项目地图：cd your-repo && npx agenttrail

Star 增长趋势

同类项目