sodiumsun/agenttrail

What it solves

Agenttrail 为 AI 编码代理提供本地可观测性，消除了从多个终端窗口中拼凑信息的需求。它允许开发者在不干扰代理的执行或决策过程的情况下，可视化项目结构、任务进度以及代理（例如 Codex 和 Claude Code）的实时动态。

How it works

Agenttrail 作为一款本地伴随工具，观察本地文件、计划和代理事件。它并不运行或控制代理；相反，它通过读取本地会话日志（session logs）与文件变更来可视化工作证据。它提供两种不同的视图：

• Map: 结合了 PLAN.md 规范（定义组件和依赖关系）与观察到的文件变更，以展示项目概览和会话轨迹。
• Kitchen: 一个实验性的 3D 视图，将项目职责表示为 "chef"，任务表示为 "ticket/dish"，并将完成的工作表示为传送带上的 "delivery"。

Who it’s for

使用 Claude Code、Codex 或 Cursor 等 AI 编码代理的开发者，他们想要对代理正在做的事情以及项目中剩余的工作进行高层级的视觉化概览。

Who it’s for

使用 Claude Code、Codex 或 Cursor 等 AI 编码代理的开发者，他们想要对代理正在做的事情以及项目中剩余的工作进行高层级的视觉化概览。

Highlights

• Local-first: 绑定到 127.0.0.1，无需账号、遥测或云端服务。
• Non-intrusive: 不发送提示词（prompts），不批准行动，也不协调代理的执行。
• Multi-tool support: 通过读取日志和可选的 hooks，与 Codex CLI、Claude Code 和 Cursor 整合。
• Two visualization styles: 提供结构化的项目地图和游戏化的 3D "kitchen" 视图的任务流。