偶尔要查的命令

命令是备用，不是入场券。正常开发可以让 AI 代跑；下面标注“项目内”的命令必须在具体项目目录执行。

第一次安装和启用

# 查看本机版本
trellis --version

# 在当前项目中为 Codex 初始化
trellis init --codex -u macdu

# 同时给多个 AI 平台初始化（按需）
trellis init --codex --claude --cursor -u macdu

# 检查当前项目启用了哪些平台
trellis platforms

以后更新

全局 CLI 和每个项目里的模板是两步更新。

# 第一步：升级全局 Trellis CLI
trellis upgrade

# 第二步：进入每个已初始化项目，先预览再同步
trellis update --dry-run
trellis update

# 只有提示 MIGRATION REQUIRED 时才使用
trellis update --migrate

不想用了

trellis uninstall --dry-run
trellis uninstall

不要直接手工删除混合了自定义内容的 AI 配置目录。先用 --dry-run 看清 Trellis 管理哪些文件。

找回以前聊过的内容

# 搜索当前项目的过往 AI 对话
trellis mem search "关键词"

# 查看完整帮助
trellis mem help

看到这些文件时不用慌

位置	用途	是否常看
`.trellis/workflow.md`	完整开发阶段、规则和完成门槛	很少，AI 会读
`.trellis/tasks/`	每个任务的 PRD、设计、实施计划和状态	确认规划时会看
`.trellis/spec/`	从真实项目提炼的编码规范与踩坑经验	偶尔审阅
`.trellis/workspace/`	开发者工作记录和会话摘要	通常不用手改
`.agents/skills/trellis-*`	Codex 等 AI 能发现的 Trellis skills	需要时可以直接点名
`.codex/`	Codex 代理配置和 hooks	配置出问题时再看
`AGENTS.md`	仓库最上层的 AI 工作规则	值得知道
`CONTEXT.md`	grill-with-docs 维护的领域术语表	术语有歧义时看
`docs/adr/`	少数难撤销、有真实取舍的决定	做重大决定时看