Terrain · 工程环境

给人和 AI，
铺同一块地

指向一个 Git 仓库，Terrain 扫代码、打包源码、生成架构文档。人读 human，Agent 读 context，谁都不用再对整个仓库盲搜。

npm i -g @terrain-ai/cli

三样东西，把地铺平

Map · 地图

知识资产

从代码生成的 C4 架构文档（给人看）和 Agent 上下文（给 AI 看），都写在仓库里的 `.terrain/`，跟着分支走，不散落在 wiki 里。

Roads · 道路

Agent 工具链

一条命令装好 CodeGraph、RTK、预置 Skills。每个 Agent 读项目的方式都一样，不再各自瞎 grep 一遍。

Trail · 路标

规范与流程

Skills、AGENTS.md，加上从需求到代码评审的四阶段 SDD。每一步留一份 Markdown，看得见、能复查。

Terrain 数据流 — Git 进，`.terrain/` 出 —— 人与 Agent 用同一套入口读同一份知识。

预览。

01 项目状态、新鲜度、就绪度，一屏看全。

四个在意的点

知识会保鲜

对照 Git HEAD 给每份知识打分；落后了就一键刷新，只更新变了的部分，不整库重来。

一套契约

Claude Code、Cursor、Codex 读的是同一份上下文，谁瞄到的项目都长一个样。

回答带出处

问代码，答案直接引文件和行号，点得开、查得到，不靠"感觉"。

全程可复查

SDD 从需求到评审，每个阶段都是一份 Markdown。不满意就改，改完再跑。

想怎么看，就怎么看。

Desktop

桌面 App

看着用 · 什么工具链都不用配

项目列表 + 每份知识的新鲜度
点开就读 C4 文档，点一下就能提问
一键装好 Skills、CodeGraph、RTK、AGENTS.md
Token 用量、成本，直接看在顶栏

CLI

命令行

管道里用 · JSON 输出进 CI

terrain

$ npm i -g @terrain-ai/cli $ terrain init ./my-repo # 扫描 + C4 文档 + Agent 上下文 $ terrain ask query "登录怎么走？" --project my-repo $ terrain refresh ./my-repo # 提交后，只刷变的部分 $ terrain tools grep-pack --project my-repo --pattern "authenticate"

桌面版自带 CLI。工程环境集成会把它装到 ~/.terrain/bin/terrain，想切到终端，随时都行。

装来用

桌面版

macOS（Apple Silicon）与 Windows x64 的预编译安装包，不用装 Rust 或 Node。

GitHub Releases

命令行

无头机器、CI、写进脚本或让 Agent 自己调。

npm install -g @terrain-ai/cli