AI 编程时代的工作区管理神器：让 Git 多任务并行像切换分支一样简单

你是否曾同时运行 3 个 Claude Code 代理处理不同功能模块，却在 git worktree add、路径跳转、分支清理间反复卡壳？Worktrunk 正是为这个「AI 原生开发流」而生的 Rust CLI 工具——它把 Git 原生但晦涩的 worktree 功能彻底重做了用户体验，让每个 AI 代理拥有独立、隔离、可一键调度的代码工作区，且所有操作只需记住 3 个核心命令。

核心功能

一行命令创建 + 切入新工作区：执行 wt switch -c -x claude feat/login 即可自动创建 feat/login 分支、生成对应 worktree 目录（如 ../myrepo.feat-login）、cd 进入，并直接启动 Claude；告别传统方式中重复输入分支名 3 次 + 手动 cd 的繁琐流程。
智能路径模板化管理：无需手动指定 worktree 路径。Worktrunk 根据配置（默认 ../{repo}.{branch}）自动生成唯一目录，支持 hash_port 等模板函数，让每个工作区自动分配独立端口（如 localhost:3001、localhost:3002），完美支撑多实例本地服务并行调试。
交互式工作区浏览器：运行 wt switch（无参数）即可唤出 TUI 界面，实时预览各 worktree 的 git status、最近提交日志、甚至 diff 变更摘要，用方向键快速选择并跳转，大幅提升多任务上下文切换效率。
PR 一键直达工作区：输入 wt switch pr:42，Worktrunk 自动拉取远程 PR 分支（如 pr-42 或 origin/pr/42），创建 worktree 并 checkout，省去 gh pr checkout 42 → git worktree add → cd 的 5 步操作。
LLM 驱动的智能提交：执行 wt commit 时，自动基于当前 diff 调用本地或远程 LLM（支持 Claude、Ollama 等）生成专业级 commit message，还可配置 hooks 在 pre-commit 阶段做语义校验，让提交历史真正“可读、可追溯、可理解”。
跨工作区共享构建缓存：利用 APFS（macOS）、btrfs（Linux）或 XFS 文件系统底层的写时复制（CoW）能力，通过 wt step copy-ignored 命令，让 10 个 worktree 共享 target/、node_modules/ 等大体积目录，零拷贝、零重建、秒级就绪。
全生命周期钩子自动化：支持 on-create、pre-merge、post-merge 等 7 类 hook，例如在 on-create 中自动 pnpm install 和 npx tsc --noEmit，或在 pre-merge 中运行单元测试，将重复操作沉淀为可复用的 workflow。
带 AI 摘要的全局视图：运行 wt list --full 不仅显示各 worktree 的状态、分支、路径，还内嵌 CI 构建结果（来自 GitHub Actions 等）和 LLM 生成的分支变更摘要（如“重构 auth 模块，新增 JWT token 刷新逻辑”），一眼掌握全部并行任务进展。

技术亮点

Rust 原生实现，零运行时依赖：全静态编译二进制，安装即用（curl + chmod 即可），无 Node.js/Python 环境要求，启动速度毫秒级，在 M1/M2 Mac 和 Linux 服务器上均表现稳定。
Git 原语深度封装，非抽象层模拟：不绕过 Git，而是精准调用 git worktree、git checkout、git merge 等底层命令，确保行为 100% 与 Git 一致；所有“魔法”都建立在 Git 官方语义之上，学习成本低、迁移风险零。
声明式路径模板引擎：采用类似 Jinja 的轻量模板语法（如 {{ branch | kebab_case }}、{{ repo | hash_port }}），配合内置变量（repo、branch、sha），让路径命名策略高度可定制，兼顾可读性与机器友好性。
面向 AI 工作流的架构设计：从诞生之初就以“支持 5–10 个 AI agent 并行编码”为约束条件设计——命令默认支持 -x <cmd> 启动外部进程（Claude/Codex/Ollama）、hook 支持异步等待、wt merge 内置 squash/rebase/cleanup 三合一逻辑，直击 AI 编程场景下的真实痛点。
渐进式功能演进模型：核心命令（switch/remove/list）极简稳定；高级功能（LLM commits、hooks、step）全部通过文档驱动开发（DDDD），每个特性均有独立文档页（如 /llm-commits/），避免功能膨胀导致的学习曲线陡峭。

适合哪些人用

Worktrunk 是为以下两类开发者量身打造的生产力杠杆：

AI 辅助编程实践者：你正在用 Claude Code 重构微服务、用 Codex 生成前端组件、用 Ollama 本地跑 Llama3 调试 prompt —— Worktrunk 让每个 agent 拥有专属沙箱，互不干扰，且能一键聚合成果。
大型单体/单仓多团队协作者：你在维护一个包含 Web、CLI、SDK 的 monorepo，前端组改 React、后端组修 Rust API、Infra 组调 Terraform —— Worktrunk 的 worktree 隔离 + 共享缓存 + PR 快速切入，让多线程协作不再抢 main 分支。

真实场景案例：
• 某 AI 工具创业团队用 Worktrunk 同时运行 7 个 Claude 实例：1 个做 UI 组件生成、2 个分别处理 Auth 和 Billing 微服务、1 个写文档、3 个做自动化测试生成。每天通过 wt list --full 查看所有分支的 CI 状态和 LLM 摘要，合并前统一执行 wt merge --squash 清理历史。
• 一位开源维护者用 wt switch pr:189 快速复现用户 Issue，本地调试后 wt merge --rebase 整洁合入，全程未离开终端，也无需打开 GitHub 页面。

快速上手

安装仅需两步（macOS/Linux）：

curl -L https://github.com/max-sixty/worktrunk/releases/latest/download/worktrunk-x86_64-apple-darwin -o /usr/local/bin/wt && chmod +x /usr/local/bin/wt

首次使用前，建议初始化配置：

wt config set worktree.template '../{{ repo }}.{{ branch | kebab_case }}'

常用命令速查：

wt switch feat/dashboard — 创建并进入 feat/dashboard 工作区
wt switch — 交互式选择已有 worktree
wt list --full — 查看带 CI 状态和 LLM 摘要的完整列表
wt remove feat/dashboard — 删除工作区及对应分支
wt merge feat/dashboard — 自动 rebase 到 main、运行测试、squash 提交、清理 worktree

同类对比 / 注意事项

vs 原生 git worktree：Worktrunk 不是替代品，而是增强层。它保留了所有 Git 原语语义，但将 5–8 步操作压缩为 1–2 个命令，并补足了缺失的 UX（状态可视化、PR 支持、hook 自动化）。
vs git-worktree-manager（Node.js）：后者功能较基础，无 LLM 集成、无跨工作区缓存、无交互式 UI；Worktrunk 的 Rust 实现带来更快响应、更低内存占用，且对 AI 工具链有原生适配。
注意事项：Worktrunk 默认不启用 LLM 功能（需手动配置 llm.provider）；APFS/btrfs/XFS 共享缓存需文件系统支持 CoW；Windows 支持处于实验阶段（推荐 WSL2 使用）。