worktrunk 是管理 git 工作树的命令行工具,命令名为 wt。它把创建分支、切换到对应目录、查看进度和清理工作树串起来,适合同时维护多个任务,或给不同的 ai 编码会话各分配一个目录。
Worktrunk 管理的是哪些目录?
Git 工作树就是同一个 Git 仓库的额外检出目录,每个目录可以单独绑定不同分支,各自保存未提交的修改。所有工作树共享同一份仓库提交历史,你在任意一个工作树里提交的内容,其他工作树都能直接同步看到。

用文档和修复任务区分目录
举个实际场景,你可以把主目录一直停在 main 分支,写文档的任务单独用 feature/docs 分支,bug 修复任务用 fix/notes 分支。打开编码助手前,先执行下面两条命令确认当前所在目录和分支,如果终端显示你现在在 main 分支,先切到对应任务的工作树再往下操作。
pwd git branch --show-current
哪些操作可以直接用 wt?
wt switch 用来创建新任务工作树,或是直接切换到已有的对应任务目录;wt list 会把所有工作树的状态汇总列出来;wt merge 可以把已经准备好的任务分支直接合并到目标分支;wt remove 用来删掉不再需要的工作树目录。开启 shell 集成之后,执行切换命令还能直接把当前终端的工作路径跳转到目标工作树的目录下。

直接看列表里的分支名和提交信息,就能快速判断每个任务的当前进度。

多个工作树会隔离哪些东西?
每个工作树的未提交代码、检出目录是完全互相独立的。但开发服务器端口、数据库以及其他外部服务的配置还是跟着整个项目走,要是两项任务同时需要跑本地服务,记得给它们分配不同的端口,核对好各自连接的数据库实例。
合并分支之前还是要照常查看 Git 差异,跑完项目的全量测试。哪怕两个会话在各自的工作树目录里都跑通了测试,只要两条分支修改了同一个文件,合并的时候还是有可能出现冲突。

















