Skip to content
Skill

iterm-worktree

by chadboyda

AI Summary

Automates git worktree creation and management with iTerm2 integration, enabling developers to work on multiple features in parallel with isolated development environments across tabs and windows.

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "iterm-worktree" skill in my project.

Please run this command in my terminal:
# Install skill into the correct directory (2 files)
mkdir -p .claude/skills/iterm-worktree && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/iterm-worktree/SKILL.md "https://raw.githubusercontent.com/chadboyda/chadboyda-agent/main/plugins/iterm-worktree/skills/iterm-worktree/SKILL.md" && mkdir -p .claude/skills/iterm-worktree/scripts && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/iterm-worktree/scripts/worktree.py "https://raw.githubusercontent.com/chadboyda/chadboyda-agent/main/plugins/iterm-worktree/skills/iterm-worktree/scripts/worktree.py"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

Manage git worktrees with iTerm2 integration. Use when user asks to create isolated development environments, work on features in parallel, manage worktrees, open worktrees in new tabs/windows, switch between worktrees, or close completed worktrees. Triggers on "create worktree", "new worktree", "feature branch with worktree", "open worktree", "switch worktree", "close worktree", "list worktrees", or mentions wanting to work on multiple features simultaneously.

Usage

Run the script at scripts/worktree.py: `bash python3 scripts/worktree.py <command> [options] `

Safety Features

• Validates no uncommitted changes before closing • Checks for unpushed commits before closing • Auto-detects default branch (main/master) • Prevents duplicate branch/path creation

iTerm2 Worktree Manager

Automate git worktree management with iTerm2 tab/window integration for parallel feature development.

Quick Reference

| Command | Description | |---------|-------------| | create <branch> | Create worktree + branch, open in iTerm2 | | close <worktree> | Safely remove worktree after validation | | list | Show all worktrees with iTerm2 tab status | | switch <worktree> | Focus existing worktree tab | | open <worktree> | Open existing worktree in new tab |

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 3mo ago
Stale
AdoptionUnder 100 stars
0 ★ · Niche
DocsREADME + description
Well-documented

GitHub Signals

Issues0
Updated3mo ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code