AgentTrail

为什么需要

用 Claude Code / Cursor / Codex 做长期出海项目,agent 跑了几天后想回头看"那天为什么改了那个文件"、"token 都花在哪"——这些数据默认不保留,agent 一关 session 就没了。AgentTrail 是本地可观测性工具,AgentTrail Map 展示项目活动结构,AgentTrail Kitchen 可视化每条 prompt/响应/工具调用,所有数据本地 SQLite 存储,不上传。

核心区别于 LangSmith 等云端可观测平台:LangSmith 把数据传到云端,海外项目代码片段外传有合规风险;AgentTrail 完全本地,合规可控。

怎么用

npm 安装两个包:

npm install -g agenttrail agenttrail-kitchen

启动:

# Map:项目结构 + 活动热力图(浏览器 dashboard)
agenttrail-map --project ~/projects/my-saas --port 7820

# Kitchen:每条 prompt/response/工具调用可视化
agenttrail-kitchen --port 7821

接入 Claude Code / Cursor,在 MCP 配置里加:

{
  "mcpServers": {
    "agenttrail": {
      "command": "agenttrail-mcp",
      "args": ["--project", "/path/to/project"]
    }
  }
}

Agent 自动把每条 prompt / 响应 / 工具调用落到本地 SQLite,浏览器 dashboard 实时刷新。

使用案例

一个出海独立开发者用 AgentTrail 复盘 agent 行为:

• 周五下班关电脑前看一周 token 消耗图(哪些任务最烧 token)
• 客户反馈"agent 改了不该改的文件",回放当天的 prompt 链,定位问题
• 多 agent 协作时(主 agent + sub agent),看每个 agent 的工具调用占比
• 出海合规自查:确认代码片段不上传到第三方

注意事项

• MIT 开源,免费商用
• 数据全部本地 SQLite,不联网,合规可控
• 需要 Claude Code / Cursor / Codex 等 MCP 兼容 agent
• 当前支持的 agent 数量还在扩展,部分 agent 可能需要定制 adapter