Worktrees

wit worktree add <path> <branch>

# Create worktree for existing branch
wit worktree add ../feature-worktree feature-branch

# Create worktree with new branch
wit worktree add ../hotfix-worktree -b hotfix-123

wit worktree list

/home/user/project         a1b2c3d [main]
/home/user/feature-wt      e5f6g7h [feature-branch]
/home/user/hotfix-wt       i9j0k1l [hotfix-123]

wit worktree remove <path>

wit worktree remove ../feature-worktree

wit worktree prune

wit stash
wit switch main
# fix bug...
wit commit -m "Hotfix"
wit switch feature
wit stash pop

# Create a worktree for the hotfix
wit worktree add ../hotfix main

# Work on hotfix in separate directory
cd ../hotfix
# fix bug...
wit commit -m "Hotfix"
wit push

# Back to feature (no context switch!)
cd ../project
# Continue exactly where you left off

# Clean up
wit worktree remove ../hotfix

~/code/
├── my-project/              # Main worktree (main branch)
│   ├── .wit/              # The actual repository
│   ├── src/
│   └── package.json
├── my-project-feature/      # Linked worktree (feature branch)
│   ├── .wit -> link       # Links to main .wit
│   ├── src/
│   └── package.json
└── my-project-hotfix/       # Linked worktree (hotfix branch)
    ├── .wit -> link
    ├── src/
    └── package.json

# Work on two features simultaneously
wit worktree add ../feature-a feature-a
wit worktree add ../feature-b feature-b

# Now you have three directories:
# - Main repo (can stay on main)
# - feature-a worktree
# - feature-b worktree

# Create worktree to test a PR
wit worktree add ../pr-123 origin/pr-123

# Test in that directory
cd ../pr-123
npm install
npm test

# Clean up
cd ../project
wit worktree remove ../pr-123

# Run a long build in a worktree
wit worktree add ../build-wt main
cd ../build-wt
npm run build:production &

# Continue working in main worktree
cd ../project
# Edit files, make commits, etc.

# Review someone's branch
wit worktree add ../review origin/teammate-feature

# Open in IDE, review, then clean up
wit worktree remove ../review