Skip to content

Latest commit

 

History

History
35 lines (27 loc) · 2.27 KB

File metadata and controls

35 lines (27 loc) · 2.27 KB

Install Arborist (agent-driven)

Arborist bundles no dependency code. The easiest install: open a fresh coding-agent session in your repo root and paste the prompt below. The agent installs the tools (Trellis; optional codegraph), runs trellis init, clones Arborist, and runs adopt.sh. Prefer this over manual steps.

Requires: Node.js + npm, git, and a repo you want to adopt Arborist into. The agent will make global npm installs and edit .git/info/exclude — it should confirm each side-effecting step with you.


你是安装助手。请把 Arborist(https://github.com/<owner>/arborist)装进当前 git 仓库。逐步做、每个有副作用的步骤先跟我确认:

1) 环境检查:node/npm/git 是否就绪;当前目录是否 git 仓库根。缺则停下告诉我。
2) 装依赖(全局 npm;已装则跳过;每类装前问我要不要):
   - 必需:`npm i -g @mindfoldhq/trellis`
   - 可选(符号/调用图):codegraph(`codegraph init && codegraph install` 建索引+MCP)
   注意:Trellis 为 AGPL-3.0,独立安装、各自 license;Arborist 只通过 CLI 与其互操作。
3) 初始化 Trellis:问我平台与开发者名,然后 `trellis init --<platforms> -u <name>`。
4) 取 Arborist 并叠加:
   `git clone https://github.com/<owner>/arborist.git /tmp/arborist && bash /tmp/arborist/adopt.sh`
   (adopt.sh 会铺 guides/scripts/hgit 与 .arborist/ 注册表脚手架、写 .git/info/exclude、建本地 .harness-vcs 历史仓,并按依赖分级告警 required 工具、逐个询问可选工具(agentsview/Multica/codegraph)——都在产品仓之外。)
5) 手动收尾(按 /tmp/arborist/ADOPT.md「手动收尾」):把 overlay/workflow-customization.md 的块粘进 .trellis/workflow.md 并替换 <占位>(<REPO_ROOT> 换成本仓绝对路径);按需配 Multica env。
6) 校验:`trellis update --dry-run` 应只把你改过的 config.yaml/workflow.md 列为「modified by you」;确认 spec/tasks/workspace 属「User data preserved」。
7) 报告:装了什么、改了哪些文件、下一步怎么开工(rootorc kickoff)。

先做第 1 步(环境检查),再逐步征询我。不要一次性全跑。

Manual install (if you'd rather not use an agent): see ADOPT.md.