Zero-friction git worktree manager for parallel feature development.

中文 • 日本語

worktree.sh automates the tedious setup of git worktrees. With a single command, it creates isolated development sandboxes for coding agents like Codex and Claude Code—complete with branches, environment files, dependencies, and running dev servers. No context pollution.

• AI-Powered Development — Isolated sandboxes for Codex and Claude Code
• Parallel Development — Multiple features without branch switching
• Quick Experiments — Safe disposable environments
• Code Reviews — Review PRs without interrupting main work

curl -fsSL https://raw.githubusercontent.com/notdp/worktree.sh/main/install.sh | bash

# 1. Initialize project (run in your main repo)
wt init

# 2. Create a worktree for feature development
wt add 3000
# This automatically:
# - Creates worktree at ../project.3000
# - Creates branch feat/3000
# - Copies .env files
# - Installs dependencies
# - Starts dev server on port 3000

# 3. Navigate between worktrees
wt 3000    # Jump to feature worktree
wt main    # Return to main repository

# 4. Merge when ready (from main worktree)
wt merge 3000

# 5. Clean up
wt rm 3000

• One-Command Setup — wt add 3000 creates worktree, branch, copies env files, installs deps, and starts dev server on port 3000
• Instant Navigation — Jump between worktrees with wt 3000 or wt main, no path memorization needed
• Smart Syncing — Propagate staged changes from main to multiple worktrees with wt sync all
• Safe Cleanup — Remove worktrees and branches together with wt rm, batch-clean with wt clean
• Fully Configurable — Control branch prefixes, auto-install, dev server behavior per project

Propagate uncommitted changes from main to multiple feature branches simultaneously:

# In main worktree
git add file1.js file2.js    # Stage changes
wt sync all                  # Sync to all worktrees
# Or sync to specific ones
wt sync 3000 3001

Note: Target worktrees must have clean status

# Disable auto dev server
wt config set add.serve-dev.enabled false

# Change branch prefix
wt config set add.branch-prefix "feature/"

# View all settings
wt config list

Configuration is stored per-project in ~/.worktree.sh/projects/<slug>/config.kv.

wt add ui-v1    # First UI approach
wt add ui-v2    # Alternative design
wt add ui-v3    # Third variation
# Compare implementations side by side

wt add review-pr-123    # Review PR #123
wt add review-pr-456    # Review PR #456
wt add review-pr-789    # Review PR #789
# Handle multiple reviews without context switching

wt add feat-auth        # Authentication feature
wt add feat-payment     # Payment integration
wt add feat-dashboard   # Dashboard redesign
# Develop multiple features in parallel

• Binary: ~/.local/bin/wt
• Config: ~/.worktree.sh/
• Shell hooks: Added to ~/.bashrc or ~/.zshrc

• Bash 3.0+
• Git 2.17+ (worktree support)
• macOS or Linux

wt reinstall    # Update to latest version

wt uninstall

Or use the uninstall script:

curl -fsSL https://raw.githubusercontent.com/notdp/worktree.sh/main/uninstall.sh | bash

Stop juggling branches. Start shipping features.

worktree.sh keeps your terminals synchronized and your focus on code, not configuration.