Worktree Manager

Git Worktree Manager

一个优雅的 Git Worktree 可视化管理工具,让多分支并行开发变得简单高效。支持远程分享与实时协作。

下载最新版 GitHub 快速开始

下载安装

开箱即用,支持自动更新

macOS (Intel + ARM)
Windows
Linux
内置自动更新 -- 安装后新版本会自动推送,无需手动下载

macOS 安装说明

1

下载 .dmg 文件,打开后将应用拖入 Applications 文件夹完成安装。

2

首次打开如提示"无法验证开发者",请右键点击 app,然后选择"打开"

3

如仍无法打开,前往系统设置 → 隐私与安全性,在底部找到提示并点击"仍要打开"

4

以上方法均无效时,打开终端执行:

xattr -cr "/Applications/Worktree Manager.app"

这些场景,是不是似曾相识?

每个开发者都经历过的效率黑洞

🔥 线上着火,但你手里的活还没提交

你正在 feature/checkout-v2 上重构结算流程,改了十几个文件,npm run dev 跑着热更新。Slack 弹出告警:线上支付回调 500 了。

传统做法:git stash → 切到 hotfixnpm install(依赖版本不一样得重装)→ 修完推上去 → 切回来 → git stash pop → 祈祷没冲突 → 重启 dev server 等构建缓存重建。15 分钟起步,线上还在报错。

传统做法

git stash checkout hotfix npm install 修 bug push checkout 回来 stash pop npm install
8 步 · 15+ 分钟 · 可能冲突

Worktree Manager

点击 "+" 新建 hotfix 修 bug push 归档
4 步 · 30 秒切换 · 原分支零影响

node_modules 自动通过 symlink 共享,秒级就绪。你的 feature 分支 dev server 还在跑,改到一半的代码一行不用动。

💥 前后端联调,分支对不上就炸

你的项目是前后端分仓:webapi。做「会员体系」需求时,两个仓库都要切到 feature/membership 分支。但同事让你帮忙看 feature/search 的问题,你切了前端忘了切后端——页面白屏,接口 404,排查半天才发现是分支没对齐。

传统做法:手动对齐两个仓库

cd web && git checkout cd api && git checkout 忘切一个? 404 / 白屏 排查 30 分钟
多仓分支靠记忆对齐 · 迟早出错

Worktree Manager:一个 worktree = 一套环境

创建 membership worktree web + api 自动检出 开发
切换 worktree = 切换整套工作环境

一个 worktree 绑定多个项目仓库,创建时所有仓库同时检出到对应分支。不存在「只切了一半」的问题。

🔄 提测合并全靠命令行肌肉记忆

需求开发完了,要合并到 test 分支给 QA 验证。每次都得:git checkout testgit pullgit merge feature/xxx → 解决冲突 → git pushgit checkout feature/xxx 切回来。一天提测三四个需求,这套操作重复到麻木,偶尔还会忘记切回来就在 test 上继续开发。

传统做法

checkout test git pull git merge 解冲突 git push checkout 回来
6 步 · 每次提测重复一遍 · 容易忘切回来

Worktree Manager

点击「合并到 test」
1 步 · 不离开当前分支 · 状态实时可见

每个项目卡片下方直接有「合并到 test」「同步 base」「推送」按钮。分支状态(领先/落后几个 commit、是否已合并 test)实时显示,一目了然。

🌐 出差在外,想看一眼公司机器上的代码

你的开发机在公司内网,出差时想看一下代码运行状态,或者在终端里执行几条命令。传统方案要么 SSH 隧道(折腾),要么 VPN + 远程桌面(卡顿)。

传统做法

配置 VPN 远程桌面连接 卡顿 & 延迟
配置复杂 · 画面卡顿 · 依赖公司网络

Worktree Manager

点击「分享」 选择隧道模式 发送链接 浏览器打开
4 步 · 内置隧道无需安装 · 支持公网/局域网

开启分享功能,支持三种模式:局域网直连WMS 内置隧道ngrok 外网穿透。WMS 隧道无需安装额外工具,一键开启公网访问。在任意浏览器中打开,密码验证后即可查看工作区状态、使用内置终端。

Git Worktree Manager 怎么解决这些问题?

基于 Git 原生的 worktree 能力构建,在同一个仓库中同时检出多个分支到独立目录,共享 .git 数据。配合自动 symlink node_modules 等大文件夹,零成本切换零额外磁盘占用

核心功能

为多分支开发量身打造

🔀

多分支并行工作

一个项目同时打开多个分支,互不干扰。不用 stash,不用 clone 多份。

🔗

智能文件夹链接

自动链接 node_modules、.next、vendor 等构建产物,避免重复安装依赖。支持自定义路径。

📂

全局文件共享

.claude、CLAUDE.md、requirement-docs 等文件可配置为全局链接,在所有 worktree 中共享。

📊

分支状态监控

实时显示提交数、未提交更改、是否合并到测试分支等信息,一目了然。

🚀

快速打开 IDE

一键用 VS Code、Cursor、IntelliJ IDEA 等打开任意 worktree,支持下拉快速切换编辑器。

💻

内置终端

每个 worktree 有独立的终端会话,支持多标签页、复制标签和全屏模式。切换 worktree 时终端状态自动保存恢复。

📦

安全归档

归档前自动检查未提交和未推送的代码,防止丢失。支持一键恢复。

🔌

多种克隆方式

支持 GitHub 简写、SSH 和 HTTPS 三种方式添加项目。

🪟

多窗口支持

每个 Workspace 可以在独立窗口中打开,同时操作多个工作区,互不干扰。

🔍

智能文件夹扫描

自动扫描项目中可以被链接的大文件夹(如 node_modules、.next、dist 等),一键添加到链接配置。

⌨️

快捷键支持

Escape 退出全屏/关闭菜单,终端支持全屏模式,操作更高效。

🔄

自动更新

内置自动更新功能,新版本自动推送通知,一键升级到最新版本。

后台远程同步

Git 远程状态后台刷新,本地数据秒级加载。切换分支不卡顿,操作按钮按需禁用,同步进度实时可见。

🎙️

语音输入终端 macOS

对着麦克风说话,语音自动转写为文字注入终端。支持语音命令(回车、删除、清空等),2秒静默自动停止,完全本地处理。

🚇

WMS 内置隧道

内置 WMS 公网隧道服务,无需安装 ngrok。一键开启,自动分配 tunnel.kirov-opensource.com 子域名,支持断线自动重连。

AI 语音精炼

集成 Qwen 大模型自动优化语音转写结果。去除口语化填充词,修正语法,保持原始语义不变。

📱

QR 码分享

分享面板自动生成二维码,手机扫一扫即可打开。支持密码内嵌链接,扫码后自动登录无需手动输入。

🌐

远程分享与协作

一键分享工作区,同事通过浏览器即可访问。支持局域网直连和 ngrok 外网穿透,内置密码保护和浏览器终端。

远程分享 & 实时协作

无需安装,浏览器打开即用

📡

局域网直连

同一网络内直接分享,最低延迟。设置端口和密码,分享给局域网内的同事即可。

🚇

WMS 内置隧道

无需安装额外工具,内置公网隧道。自动分配 tunnel.kirov-opensource.com 子域名,支持断线自动重连和重试倒计时。

🌍

ngrok 穿透

配置 ngrok token 后一键开启外网隧道,生成公网地址。适合已有 ngrok 账号的用户。

📱

QR 码分享

分享面板自动生成二维码,手机扫码即可打开工作区。

🔑

密码内嵌链接

生成带密码的分享链接,打开后自动登录,无需手动输入密码。

👥

客户端管理

实时查看所有连接的客户端,支持单独踢出指定会话。

三步上手

简单几步,开始多分支并行开发

1

创建工作区(Workspace)

启动应用后,点击左上角的"新建 Workspace"按钮,选择一个目录作为工作区根目录。应用会自动初始化目录结构并识别其中的 Git 项目。

  • 新建工作区:选择一个空目录,应用会自动创建 projects/worktrees/ 目录
  • 导入已有项目:选择包含 Git 项目的目录,应用会自动检测并导入
  • 也可以通过 GitHub 简写(如 owner/repo)、SSH 或 HTTPS 地址添加新项目
2

新建 Worktree(工作分支)

点击侧边栏的"+"按钮,在弹出的对话框中完成以下设置:

  • 输入分支名(如 feature/login),支持 feature/hotfix/ 等命名规范
  • 选择需要包含的项目(可以多选)
  • 选择基于哪个分支创建(默认 main)
  • node_modules 等配置好的文件夹会自动从主仓库链接,无需重新安装依赖
3

开始开发

在列表中点击切换 worktree,用你喜欢的 IDE 一键打开。各分支的代码、依赖、终端完全隔离,互不干扰。

  • 点击 IDE 按钮,快速用 VS Code、Cursor、IDEA 等打开项目
  • 使用内置终端运行命令,无需切换窗口
  • 实时查看分支状态:提交数、未推送变更、是否已合并到测试分支
  • 完成开发后归档 worktree,保持工作区整洁

工作区目录结构

workspace/
├── .worktree-manager.json        # 工作区配置
├── projects/                     # 主仓库(main 分支)
│   ├── frontend/
│   └── backend/
├── worktrees/                    # Worktree 目录(自动创建)
│   ├── feature-login/
│   │   ├── projects/
│   │   │   ├── frontend/         # 独立分支的工作目录
│   │   │   └── backend/
│   │   ├── .claude → ../../.claude   # 自动链接
│   │   └── CLAUDE.md → ../../CLAUDE.md
│   └── hotfix-bug/
│       └── ...
├── .claude/
└── CLAUDE.md
🛠️ 从源码构建(面向开发者)
# 环境要求:Node.js 20+、Rust 1.70+、Git 2.0+ # 克隆项目 git clone https://github.com/guoyongchang/worktree-manager.git cd worktree-manager # 安装依赖 npm install # 开发模式运行 npm run tauri dev # 构建生产版本 npm run tauri build

技术栈

基于现代技术构建

框架 Tauri 2
前端 React 19
语言 TypeScript + Rust
样式 Tailwind CSS 4
UI 组件 Radix UI
构建 Vite 7