Git Worktree Studio

Multi-repo, multi-branch parallel development using git worktrees — with a built-in MCP server for AI model integration (Claude, Copilot, GPT).

---

What Problem Does This Solve?

Without worktrees, switching branches means stashing, waiting, context-switching. With Git Worktree Studio, each branch lives in its own folder — you develop feat-auth, fix-bug, and main simultaneously, side-by-side in VS Code.

---

Architecture

---

Parallel Development Workflow

---

Features

Core Capabilities

Repositories

• Auto-discover all repos in multi-root workspace
• Expandable tree with ahead/behind counts
• Multi-root workspace support

Branches & Worktrees

• Create worktree branches — develop in parallel folders
• Switch branches without stashing
• Rename · Delete · List local + remote branches

Source Control

• Commit · Amend · Push · Pull · Sync
• Fetch all remotes
• Merge · Rebase
• Create PR via gh (GitHub) or az (Azure DevOps)

Stash

• List all stashes
• Pop · Drop individual stash

MCP Server — AI Integration

• 27 tools for AI models (Claude, Copilot, GPT)
• stdio JSON-RPC protocol
• Full git operations via tool calls

UI

• Status bar branch indicator
• Keyboard shortcuts
• Configurable auto-refresh

---

MCP Server — AI Integration

Connect AI models (Claude, Copilot, GPT) to your git repos and let them operate across branches in parallel.

MCP Tools Reference

Category	Tools
Repos & Branches	list_repos, create_branch, remove_branch, get_branch_info, list_branches, switch_branch, rename_branch
File Operations	list_changes, read_file, write_file, diff, stage_files, unstage_files, discard_changes
Commits	commit, amend_commit, log
Remote Sync	push, pull, fetch, create_pull_request
Stash	stash, stash_pop, stash_drop, list_stashes
History	merge, rebase

---

Installation

Prerequisites

Requirement	Version	Notes
Node.js	18+	Required
VS Code	1.85+	Required
Git	2.30+	Required
GitHub CLI gh	any	Optional — for GitHub PRs
Azure CLI az	any	Optional — for Azure DevOps PRs

Install from VSIX (build from source)

# 1. Clone & install dependencies
git clone https://github.com/UpadhyayAmit/git-worktree-studio
cd git-worktree-studio
npm install

# 2. Compile & package
npm run compile
npm run package       # produces git-worktree-studio-0.5.0.vsix

# 3. Install in VS Code
code --install-extension git-worktree-studio-0.5.0.vsix --force

Install from Marketplace

Search for "Git Worktree Studio" in the VS Code Extensions panel, or visit the Marketplace page.

---

Configuration

Setting	Default	Description
gitWorktreeStudio.autoRefreshInterval	30000	Auto-refresh in ms (0 = disabled)
gitWorktreeStudio.discoveryDepth	2	Max depth for repo discovery (1–5)

---

Keyboard Shortcuts

Win / Linux	macOS	Command
Ctrl+Shift+G R	Cmd+Shift+G R	Refresh
Ctrl+Shift+G F	Cmd+Shift+G F	Fetch All
Ctrl+Shift+G N	Cmd+Shift+G N	Create Worktree Branch

---

MCP Server Setup

Add to your VS Code mcp.json (%APPDATA%\Code\User\mcp.json on Windows):

{
  "servers": {
    "git-worktree-studio": {
      "type": "stdio",
      "command": "node",
      "args": ["<path-to-extension>/out/mcp/server.js"]
    }
  }
}

Verify the server starts correctly:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | node out/mcp/server.js

---

License

MIT — © Amit Upadhyay