Trail Code

它做什么

• 代码图谱（前 graft map）：本地索引每个函数与它的调用方——agent 直达该改的文件，看得清一次改动会波及什么
• 学习层：沉淀你、你的 agent 与团队学到的、决定过的东西，agent 从你停下的地方接着干；首次运行通读仓库过往 Claude Code 会话作种子
• 一条命令完成接线：`trail init` 询问要接入哪些编程 agent、构建图谱、创建 .trail/，并给 Claude Code 加上 statusline 与 hooks
• 厂商自报的 162 轮基准：工具调用省 46%、未命中缓存输入 token 省 42%、耗时省 60%；SWE-bench Verified 50 题解出 33 对冷启动的 27
• 无守护进程、无服务端——图谱与学习全是本地文件；以 @trailhq/trail-code npm CLI 发布

什么时候用

适合厌倦了每个会话都重新解释代码库的团队：图谱让 agent 直达该改的文件，学习层让它从你和团队停下的地方接着干。也适合 agent 密集、同一批纠正总被反复发现而无法沉淀的工作流。

如何上手

npm install -g @trailhq/trail-code   # 安装 CLI，一次即可；Node 22.3+（20.16 也可）
trail init                            # 在你的仓库里：构建 graft 图谱、建好 .trail/、接入你的 agent

注意事项

性能数字是厂商自报——请在自己的仓库上验证。`trail init` 会通读仓库过往的 Claude Code 会话一次（由你本机的 Claude Code 执行，约一分钟），并写入 .trail/、statusline 与 hooks——提交前先审查。`npm install -g` 报 EACCES 时，README 记载了用户级 npm prefix 的解决办法。遥测匿名，TELEMETRY.md 记载退出方式。MIT。