A friendly CLI tool for managing multiple git worktrees, perfect for juggling different features, experiments, or Claude Code sessions without the context-switching headaches.

ccswitch helps you create and manage git worktrees with a clean, intuitive interface. Each worktree gets its own directory, letting you work on multiple features simultaneously without stashing changes or switching branches in place.

• 🚀 Quick Session Creation - Describe what you're working on, get a branch and worktree instantly
• 📋 Interactive Session List - See all your active work sessions with a clean TUI
• 🧹 Smart Cleanup - Remove worktrees and optionally delete branches when done
• 🐚 Shell Integration - Automatically cd into new worktrees (no copy-pasting paths!)
• 🎨 Pretty Output - Color-coded messages and clean formatting

# Clone the repo
git clone https://github.com/ksred/ccswitch.git
cd ccswitch

# Build and install
make install

# Add shell integration to your .bashrc or .zshrc
cat bash.txt >> ~/.bashrc  # or ~/.zshrc
source ~/.bashrc           # or ~/.zshrc

# Build the binary
go build -o ccswitch .

# Move to your PATH
sudo mv ccswitch /usr/local/bin/

# Add the shell wrapper
source bash.txt

ccswitch
# 🚀 What are you working on? Fix authentication bug
# ✓ Created session: feature/fix-authentication-bug
#   Branch: feature/fix-authentication-bug
#   Path: /home/user/project/../fix-authentication-bug
# 
# Automatically switches to the new directory!

ccswitch list
# Shows an interactive list of all your worktrees
# Use arrow keys to navigate, Enter to select, q to quit

ccswitch switch
# Interactive selection of session to switch to

ccswitch switch fix-auth-bug
# Direct switch to a specific session
# Automatically changes to the session directory!

ccswitch cleanup
# Select a session interactively, or:

ccswitch cleanup fix-authentication-bug
# Delete branch feature/fix-authentication-bug? (y/N): y
# ✓ Removed session and branch: fix-authentication-bug

# Run directly
make run

# Run tests
make test

# See all commands
make help

# Unit tests only (fast, no git required)
make test-unit

# All tests including integration
make test

# Run tests in Docker (clean environment)
make test-docker

# Generate coverage report
make coverage

ccswitch/
├── main.go              # Main application code
├── bash.txt             # Shell integration wrapper
├── Makefile            # Build automation
├── *_test.go           # Test files
├── Dockerfile.test     # Docker test environment
└── README.md           # You are here! 👋

1. Session Creation: Converts your description into a branch name (e.g., "Fix login bug" → feature/fix-login-bug)
2. Centralized Storage: Creates worktrees in ~/.ccswitch/worktrees/repo-name/session-name - your projects stay clean!
3. Automatic Navigation: The bash wrapper captures the output and cds you into the new directory
4. Session Tracking: Lists all worktrees except the main one as active sessions

~/.ccswitch/                      # All ccswitch data in your home directory
└── worktrees/                    # Centralized worktree storage
    ├── my-project/               # Organized by repository name
    │   ├── fix-login-bug/        # Individual sessions
    │   ├── add-new-feature/
    │   └── refactor-ui/
    └── another-project/
        ├── update-deps/
        └── new-feature/

# Your project directories remain completely clean!
/Users/you/projects/
├── my-project/                   # Just your main repository
└── another-project/              # No clutter!

• Go 1.21 or higher (for building)
• Git 2.20 or higher (for worktree support)
• Bash or Zsh (for shell integration)

• Use descriptive session names - they become your branch names!
• Regular cleanup keeps your workspace tidy
• Each worktree is independent - perfect for testing different approaches
• The tool respects your current branch when creating new sessions

"Failed to create worktree"

• Check if the branch already exists: git branch -a
• Ensure you're in a git repository
• Verify you have write permissions in the parent directory

Shell integration not working

• Make sure you've sourced the bash wrapper
• Check that ccswitch is in your PATH
• Try using the full path: /usr/local/bin/ccswitch

MIT License - feel free to use this in your projects!

Found a bug? Have an idea? Feel free to open an issue or submit a PR!

Made with ❤️ for developers who juggle multiple features at once