Claude Code Git Worktree Zellij

Work on multiple branches simultaneously with git worktrees, zellij panes, and Claude Code instances.

Imagine working on a feature branch while simultaneously fixing a bug on another branch, all without the hassle of switching contexts. CCGWZ makes this possible by:

• 🌿 Creating isolated git worktrees for each branch
• 🖥️ Setting up organized zellij panes
• 🤖 Launching Claude Code in each workspace

# Just run it!
npx ccgwz
# or
bunx ccgwz

# Or install globally
npm install -g ccgwz
# or
bun install -g ccgwz

Requirements: Git repo + Zellij + Claude Code

ccgwz                    # Interactive: create 1 pane
ccgwz --panes 2          # Create 2 panes

Add this to your shell profile (.bashrc, .zshrc, etc.) for quick access:

alias zz="bunx ccgwz"
# or if you prefer npm
alias zz="npx ccgwz"

Then simply run:

zz              # Launch CCGWZ instantly!
zz --panes 3    # Create 3 panes quickly

1. 📍 Validates your environment (git repo, zellij running)
2. 💬 Prompts for branch names interactively
3. 🌳 Creates worktrees like ../myproject-feature/
4. 🎛️ Arranges zellij panes in optimal layout
5. 🚀 Launches Claude Code in each workspace

• Setup & Development - Development environment setup
• Architecture & Design - Technical architecture
• Troubleshooting - Common issues and solutions
• Project Status - Development roadmap

• NPM Package - Published package on NPM

We welcome contributions! See docs/SETUP.md for development setup.

MIT