trailhq/Trail-Code

这是什么？

核心功能

• 01使用 tree-sitter 在本地构建文件、函数及调用关系的代码图，无需模型。
• 02每次查询时刷新代码地图，反映未提交的改动。
• 03将经验以 Markdown 文件形式保存在仓库中，通过 PR 评审。
• 04提交 PR 前运行 trail check，将分支与已记录的经验比对。
• 05个人经验保存在 ~/.trail 中，不会提交。
• 06支持 24 种语言，包括 TypeScript、Python、Go、Java 和 Rust。

适用场景

• 为 Claude Code 或 Cursor 提供大型代码库的地图，减少其打开的文件数量。
• 记录设计决策的原因，避免后续智能体会话将其推翻。
• 在合并前发现与队友已记录决策相冲突的改动。
• 智能体在陌生仓库中工作时，降低 token 消耗和会话耗时。

快速上手

1. 1

   从 npm 全局安装 CLI

   npm install -g @trailhq/trail-code
2. 2

   在仓库中构建代码图并配置智能体

   trail init

使用前须知

• !Trail-code 需要 Node 22.3 或更新版本（20.16 也可以），旧版本 Node 需要先升级。
• !学习内容以文件形式存放在仓库中，个人学习内容则只保存在你的本机上。

收录于专题

标签

常见问题

Trail-Code 是什么？

为 Claude Code、Cursor 等编码智能体提供代码地图和团队决策记录的上下文层。 Trail-code（原名 graft）为编码智能体提供两样东西：代码地图和经验记录。代码地图在本地用 tree-sitter 构建，记录每个文件、函数及其调用关系，帮助智能体快速定位相关代码，并看出一次改动可能影响的范围。这一部分不需要模型或 API 密钥，文件变化时会自动刷新，包括未提交的改动。

Trail-Code 可以免费使用吗？用的什么许可证？

Trail-Code 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

Trail-Code 还在维护吗？

活跃维护中。Trail-Code 最近一次提交是在 2026年11月6日。

Trail-Code 适合用来做什么？

为 Claude Code 或 Cursor 提供大型代码库的地图，减少其打开的文件数量。 记录设计决策的原因，避免后续智能体会话将其推翻。 在合并前发现与队友已记录决策相冲突的改动。 智能体在陌生仓库中工作时，降低 token 消耗和会话耗时。

Trail-Code 怎么安装和运行？

从 npm 全局安装 CLI: npm install -g @trailhq/trail-code 在仓库中构建代码图并配置智能体: trail init

在哪里获取 Trail-Code？

源代码和安装说明在 GitHub 上：https://github.com/trailhq/Trail-Code