guoyongchang/worktree-manager
Developer toolsA simple GUI to manage Git Worktrees. Visual Git Worktree manager for parallel branch development. Multi-repo workspaces, smart symlinks, built-in terminal, browser remote access, and AI-ready MCP...
Overview
Work on multiple branches simultaneously, across multiple repos, without stash, clone, or context-switching pain. Quick Start • Features • Screenshots • FAQ • 中文 You're deep in a feature branch. Fifteen files changed. Dev server running. Then Slack pings: . — git stash → switch branch → npm install → wait for rebuild → fix → switch back → git stash pop → pray for no conflicts → restart dev server. — Click "New Worktree", type hotfix-payment, done. Your feature branch keeps running. Dependencies are shared via symlink — instant setup. Fix, push, archive. Group related repos into a . Creating a Worktree creates a git worktree across all linked projects at once. Each Worktree gets its own terminal — run Claude Code, Codex, or Cursor in parallel across different branches without conflicts. P0 alert mid-development? Create a hotfix-payment Worktree → AI-assisted fix → merge to main → archive → switch back. 1. — Point to your project directory or create a new one 2.
README
Why Worktree Manager?
You’re deep in a feature branch. Fifteen files changed. Dev server running. Then Slack pings: production is down.
Without Worktree Manager — git stash → switch branch → npm install → wait for rebuild → fix → switch back → git stash pop → pray for no conflicts → restart dev server. 15 minutes minimum.
With Worktree Manager — Click “New Worktree”, type hotfix-payment, done. Your feature branch keeps running. Dependencies are shared via symlink — instant setup. Fix, push, archive. 30 seconds.
Multi-Repo Workspaces & Parallel AI Development
Group related repos into a Workspace. Creating a Worktree creates a git worktree across all linked projects at once. Each Worktree gets its own terminal — run Claude Code, Codex, or Cursor in parallel across different branches without conflicts.
Zero-Cost Context Switching
P0 alert mid-development? Create a hotfix-payment Worktree → AI-assisted fix → merge to main → archive → switch back. Uncommitted code, terminal output, dev servers — everything stays intact.
📸 Screenshots
| Main Interface | Create Worktree |
|---|---|
| Terminal & AI Coding | Browser Remote Access |
|---|---|
| Voice Input & AI Refine |
|---|
🚀 Quick Start
Download
| Platform | Download |
|---|---|
| macOS | .dmg |
| Windows | -setup.exe |
| Linux | .AppImage / .deb |
Only requirement: Git 2.0+. No Node.js or Rust needed at runtime.
Get Started in 3 Steps
- Create a Workspace — Point to your project directory or create a new one
- Add Projects — Import repos via GitHub shorthand (
owner/repo), SSH, or HTTPS - Create Worktrees — Click “+”, name your branch, select projects, go
That’s it. Your worktree is ready with all dependencies symlinked and terminals pre-configured.
✨ Features
Core
| Feature | Description |
|---|---|
| 🌿 Parallel Branches | Work on multiple branches at the same time in isolated directories, sharing the same .git data |
| 📦 Multi-Repo Workspaces | Group related repos (frontend + backend + shared libs) — create a worktree and all repos switch together |
| 🔗 Smart Symlinks | Auto-link node_modules, .next, vendor, target etc. Zero disk waste, zero reinstall |
| 🏷️ Tag Organization | Tag projects by team, domain, or stack. Filter and batch-select when creating worktrees |
Git Operations
| Feature | Description |
|---|---|
| 🔄 One-Click Operations | Sync, merge to test, pull, push — all from the UI with real-time diff stats |
| 📊 Branch Insights | See how many commits you’re ahead/behind at a glance |
| ⚡ Batch Actions | Trigger operations across all projects in a worktree simultaneously |
| 📝 AI Commit Messages | Generate commit messages with Qwen AI (optional) |
Terminal & Remote
| Feature | Description |
|---|---|
| 💻 Built-in Terminal | Full terminal emulator (xterm.js + PTY) with shell integration and search |
| 🎤 Voice Input | Speak to type in terminal — powered by Dashscope ASR with AI text refinement |
| 🌐 Browser Remote | Share your workspace over the network with password protection |
| 🔒 ngrok Tunneling | Optional public access via ngrok — no port forwarding needed |
Integrations
| Feature | Description |
|---|---|
| 🖥️ IDE Integration | One-click open in VS Code, Cursor, or IntelliJ IDEA |
| 🤖 AI-Ready (MCP) | Built-in MCP server — let Claude Code, Cursor, or Codex manage worktrees via natural language |
| 📁 Safe Archiving | Archiving only hides a worktree (files, branches and git state stay untouched); pre-archive checks flag uncommitted or unpushed work. Restore instantly |
❓ FAQ
📂 How It Works
🔧 Building from Source
Contributing
Contributions are welcome! Please open an issue first to discuss what you’d like to change.
License
Install
This server does not publish a one-line install command.
Open the repository installation guide