max-sixty/worktrunk

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

這是什麼

Worktrunk 是以 Rust 開發的 Git worktree 管理命令列工具，針對平行執行 AI 程式代理的工作流程設計。Git worktree 能讓同一個儲存庫擁有多個工作目錄，讓不同任務各自修改檔案；麻煩在於建立、切換與清理時，還得管理分支和目錄路徑。

它的核心做法是以分支名稱操作工作目錄，路徑交給可設定的範本計算，再用簡短指令串起建立、啟動代理與收尾。這不是另一個寫程式的模型，而是降低同時處理多條開發線的操作成本。

為什麼上榜

本次日榜資料顯示，專案累積 10,467 顆星，當期增加 438 顆。README 點出的需求很具體：當 Claude Code、Codex 能獨立處理較長任務，開發者便可能同時管理多個代理；這時重複輸入路徑、查分支狀態與清理目錄，就成了頻繁的管理負擔。

值得注意的差異是，它不只縮短 Git 指令，還將 hooks、合併流程與狀態預覽放進同一套工具。吸引力在於把零散步驟整理成可重複的流程，而不是宣稱代理因此更會寫程式；星數反映關注度，也不等於開發品質或效率已獲驗證。

適合誰，可以拿來做什麼

最適合同時開發多個功能、修錯與補測試的人，以及已經使用 Claude Code 等工具的開發者。每項任務建立獨立 worktree，再透過清單查看變更和領先提交，能減少來回辨認目錄的心力。不使用 AI，也能採用這種分支工作方式。

上手仍需要理解分支、提交與合併；工作目錄分開，不代表最後整合時不會有衝突。README 另提供每個 worktree 配置開發伺服器連接埠的做法，適合需要同時預覽不同功能的情境。

上手

macOS 或 Linux 可依 README 使用 Homebrew，並安裝 shell 整合，讓指令能切換目前目錄：

brew install worktrunk && wt config shell install
wt switch --create feature-auth
wt list

若已安裝 Claude，可用 wt switch -c -x claude feature-a 建立工作目錄並啟動它。完成後要分清 PR 與本機合併兩條路：走 PR 流程，待合併後用 wt remove 清理；wt merge main 則整合壓縮提交、rebase、快轉合併與清理，不只是切回主分支。

README 重點摘要

• Hooks 可在建立、合併前後等時點執行指令，自動化環境準備。
• 互動選擇器提供 CI 狀態與差異、提交紀錄、PR 和留言預覽。
• 寫入時複製建置快取列明適用 APFS、btrfs、XFS，不宜假設所有檔案系統都有同樣效果。
• LLM 輔助功能包含依差異產生提交訊息，以及分支摘要。
• Windows 指令名稱可能與 Terminal 的 wt 衝突；README 提供 git-wt 的替代方式。