这个项目能做什么

Worktrunk 是一个命令行工具,让 git worktree 的管理像分支一样简单,专门面向并行运行多个 AI 代理(如 Claude Code 或 Codex)的开发者。它提供三个核心命令——`wt switch`、`wt list` 和 `wt merge`——用于简化 worktree 的创建、切换、列出和清理。Worktree 通过分支名寻址,路径由可配置模板计算得出,命令也接受 worktree 路径。 主要功能包括: - **核心命令**:`wt switch` 用于创建/切换 worktree(`-c` 用于创建,`-x` 用于运行命令,例如启动代理),`wt list` 显示所有 worktree 及其状态、CI 信息和 AI 生成的摘要,`wt merge` 一步完成 squash/rebase/merge 并清理,`wt remove` 用于清理。 - **工作流自动化**:针对 create、pre-merge、post-merge 事件的钩子;LLM 生成的提交信息;带流式 CI 状态和 diff/log/PR 预览的交互式选择器;写时复制构建缓存共享(在 APFS、btrfs、XFS 上用于 `target/`、`node_modules/` 等);通过 `wt switch pr:123` 检出 PR;通过 `hash_port` 模板过滤器为每个 worktree 分配开发服务器端口;别名和按分支变量。 - **并行代理支持**:使用简单命令在独立 worktree 中启动多个代理,例如 `wt switch -x claude -c feature-a -- 'Add user authentication'`。 - **安装**:可通过 Homebrew、Cargo、Winget(Windows,名为 `git-wt`)、Arch Linux pacman、Conda/Pixi 安装。Shell 集成(`wt config shell install`)可启用切换目录的命令。 - **文档**:完整文档见 worktrunk.dev,包含钩子、LLM 提交、合并工作流、技巧与模式以及通过别名扩展的指南。 Worktrunk 使用 Rust 编写,基于 MIT 或 Apache-2.0 开源。它旨在减少管理大量并行 worktree 的摩擦,非常适合 AI 代理驱动的开发工作流。