satococoa/wtp

这是什么？

核心功能

• 01根据分支名自动生成 worktree 路径。
• 02使用 wtp remove --with-branch 一次删除 worktree 及其分支。
• 03通过 .wtp.yml 配置创建后的 hooks，支持复制文件、创建符号链接和执行初始化命令。
• 04本地不存在分支时自动跟踪远程分支。
• 05wtp cd 支持按名称切换 worktree，并为 Bash、Zsh、Fish 提供 Tab 补全。

适用场景

• 同时处理多个功能分支，无需频繁 stash 改动。
• 在微服务或 monorepo 项目中，用 .env 和依赖安装快速初始化新 worktree。
• 功能完成后连同 worktree 一起清理对应分支。

快速上手

1. 1

   使用 Homebrew 安装（macOS/Linux）

   brew install satococoa/tap/wtp
2. 2

   或使用 Go 安装

   go install github.com/satococoa/wtp/v2/cmd/wtp@latest
3. 3

   用新分支创建 worktree

   wtp add -b feature/new-feature

使用前须知

• !需要 Git 2.17 或更高版本。
• !预编译二进制文件仅提供 macOS Apple Silicon 和 Linux 版本，不包括 Intel Mac 或 Windows。

收录于专题

标签

常见问题

wtp 是什么？

一个 Git worktree 命令行工具，按分支名自动生成路径，支持创建后自动执行设置脚本，并可连同分支一起删除 worktree。 wtp（Worktree Plus）是一个命令行工具，在 git worktree 的基础上提供更多便利，方便同时检出和管理多个分支。执行 wtp add feature/auth 即可按分支名自动生成 worktree 路径，无需手动输入较长的相对路径。遇到仅存在于远程的分支时会自动跟踪检出；若分支同时存在于多个远程，则会给出明确的报错提示。

wtp 可以免费使用吗？用的什么许可证？

wtp 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

wtp 还在维护吗？

活跃维护中。wtp 最近一次提交是在 2026年11月3日。

wtp 适合用来做什么？

同时处理多个功能分支，无需频繁 stash 改动。 在微服务或 monorepo 项目中，用 .env 和依赖安装快速初始化新 worktree。 功能完成后连同 worktree 一起清理对应分支。

wtp 怎么安装和运行？

使用 Homebrew 安装（macOS/Linux）: brew install satococoa/tap/wtp 或使用 Go 安装: go install github.com/satococoa/wtp/v2/cmd/wtp@latest 用新分支创建 worktree: wtp add -b feature/new-feature

在哪里获取 wtp？

源代码和安装说明在 GitHub 上：https://github.com/satococoa/wtp