-
securityA
license-
qualityA comprehensive code analysis and management tool that integrates with Claude Desktop to analyze code at project and file levels, helping adapt changes to projects intelligently.
Last updated -
37
Python
MIT License
Provides git worktree management capabilities, including creating new worktrees with feature branches, closing worktrees after verifying they're clean and pushed, and listing active worktrees.
Integrates with iTerm2 terminal to open worktrees in new tabs, switch between tabs containing worktrees, and detect which tabs are running specific worktrees across different windows.
iTerm2 Worktree MCP Server
A Model Context Protocol (MCP) server that automates git worktree management with iTerm2 integration for Claude Code.
https://github.com/user-attachments/assets/16188878-8fe8-450c-b2a3-cfd617d74f43
Installation
Add to Claude Code:
Features
Core Worktree Management
- Create Worktree: Creates a new git worktree with a feature branch and opens it in a new iTerm2 tab
- Close Worktree: Safely closes worktrees after verifying they're clean and pushed
- Open Worktree: Opens an existing worktree in a new iTerm2 tab (with force option to override if already open)
Navigation & Discovery
- Active Worktrees: Lists all git worktrees and shows which iTerm2 tabs they're running in
- Switch to Worktree: Quickly switch to a worktree's iTerm2 tab by name or specific tab ID
Smart Tab Detection
- Dynamic Discovery: No metadata files - finds tabs by analyzing their working directories in real-time
- Multi-Tab Support: Shows all tabs running the same worktree across different windows
- Window Context: Identifies which tabs are in the current window with
thisWindowflag
Available Tools
| Tool | Description | Parameters |
|---|---|---|
createWorktree | Create new worktree + branch, open in iTerm2 tab | feature_name, branch_name, worktree_folder, description, start_claude? |
closeWorktree | Validate, close, and cleanup worktree | worktree_name |
activeWorktrees | List all worktrees and their iTerm2 tabs | None |
switchToWorktree | Switch to worktree's iTerm2 tab | worktree_name, tab_id? |
openWorktree | Open existing worktree in new tab | worktree_name, force? |
Workflow
- Create:
createWorktree- Specify feature name, branch name, and worktree folder - automatically creates the worktree and switches to a new iTerm2 tab - Navigate:
switchToWorktreeoropenWorktree- Seamlessly move between worktrees - Monitor:
activeWorktrees- See all worktrees and their active tabs - Develop: Work in isolated worktree environments with full iTerm2 integration
- Close:
closeWorktree- Verify changes are committed and pushed, then safely remove the worktree
Perfect for feature development with isolated git environments and seamless iTerm2 integration.
This server cannot be installed
Automates git worktree management with iTerm2 integration for Claude Code, allowing users to create, manage, and close git worktrees in isolated environments with automatic tab handling.
Related MCP Servers
- -securityFlicense-qualityA Multi-Claude Program for interacting with GitHub APIs through Claude Desktop, allowing users to search repositories, manage issues, pull requests, repository settings, workflows, and collaborators.Last updated -1Python
- AsecurityFlicenseAqualityEnables comprehensive GitHub operations through natural language including file management, repository administration, issue tracking, and advanced code searching.Last updated -4711TypeScript
- -securityAlicense-qualityConnects Claude Desktop to GitHub repositories, enabling users to perform git operations and GitHub API interactions through natural conversation.Last updated -JavaScriptMIT License