Worktree 会话在仓库的隔离副本中运行，因此并行 agents 无法覆盖彼此的文件。Worktrees 需要 git 仓库，位于 ~/.grok/worktrees/<repo>/<name> 下，并从当前 HEAD 开始，其中包括未提交的更改。当父 Agent 委派并行工作时，Subagents 也可以请求 worktree 隔离。

启动 Worktree

grok -w
grok --worktree=feat "refactor module X" # = keeps the prompt out of the name
grok -w --ref main "fix the flaky test"  # clean checkout of the ref
grok -w -r <session-id>                  # resume in a fresh worktree

在 TUI 中：/fork --worktree 会将当前会话 fork 到 worktree；欢迎界面中的 Ctrl+W 打开 New Worktree 对话框；Ctrl+W 在 Agent Dashboard 中会将新 agents 分派到 worktrees。/new 和 /fork 是否提供 worktree 可进行配置，请参阅 TOML Values。

Worktree 是真实的 git checkout，在 base commit 上处于 detached 状态；使用普通 git 命令合入更改。

清理

Worktrees 会一直保留到你主动移除它们：结束或删除会话后，其 worktree 仍会保留；gc 只会在你调用时运行。

命令	作用
`grok worktree list`	列出已跟踪的 worktrees
`grok worktree show <id>`	显示某个 worktree 的详情
`grok worktree rm <ids...>`	移除 worktrees（使用 `--dry-run` 预览）
`grok worktree gc`	移除目录已不存在的条目；`--max-age 7d` 还会清理未被运行中 process 使用的闲置 worktrees

最后更新：2026 年 7 月 21 日