/worktree
在一个新的 Git worktree 中启动聊天。
/worktree 会让当前聊天在一个新的 Git worktree 中启动,而不是在常规的工作目录中。worktree 是从同一个仓库检出的一份额外工作副本,拥有自己的分支——Agent 的改动会落在这个副本里,不会触及你的主分支。这样一来,多个聊天就可以并行处理同一个项目而互不干扰;根据文档,预定的后台任务也会运行在各自独立的 worktree 上。
对你这个 CLI 用户来说重要的一点是:根据官方文档,这个 worktree 选择功能只在 ChatGPT 桌面应用内的 Codex 中可用(在新建聊天时通过 Composer 菜单选择),纯终端 CLI 中不可用。/worktree 出现在 Codex 通用命令参考中,但不在终端 CLI 自己的命令列表里。在纯终端环境下,你只能用 git worktree add 手动实现同样的效果。
✅ 什么时候用？
让多个聊天并行处理同一个仓库,又不互相干扰
在桌面应用中使用 /worktree,同时另一个聊天继续在主分支上工作
在触及主分支之前,先隔离试验一次有风险的重构
/worktree,在新分支中完成重构,之后再合并
⛔ 什么时候不该用？
你只在终端 CLI 中工作
根据文档,worktree 功能只在 ChatGPT 桌面应用内的 Codex 中可用;终端 CLI 并没有把 /worktree 作为独立命令。
更好的选择: 手动使用 git worktree add,或者改用桌面应用
不存在 Git 仓库
worktree 需要有一个 Git 仓库作为前提。
更好的选择: 留在常规工作区中
来源
- Codex CLI 文档：Slash Commands ↗ learn.chatgpt.com
更多命令 · Codex CLI