Wm Git Worktree Manager

WM - Git Worktree Manager

CLI tool for easy git worktree management.

IMPORTANT: Non-Interactive Mode Required

Always use explicit arguments. Interactive mode does not work in automated environments.

# CORRECT - explicit arguments
wm add feature-auth
wm remove feature-auth

# WRONG - interactive mode (will hang)
wm add      # NO!
wm remove   # NO!

Quick Reference

Common Patterns

Create Worktree

# Basic usage
wm add feature-login

# With custom path
wm add feature-login -p ./workspaces/login

# Branch with slash becomes hyphenated folder
wm add feature/auth
# Creates: ../wm_repo/feature-auth/

Remove Worktree

# By branch name
wm remove feature-auth

# By path
wm remove ../wm_repo/feature-auth

# Also delete the git branch
wm remove -b feature-auth

# Force (skip confirmation)
wm remove -f feature-auth

List Worktrees

wm list
# or
wm ls

Configuration (.wm.yaml)

version: 1

worktree:
  base_dir: "../wm_{repo}"  # {repo} replaced with repo name

sync:
  - ".env"                  # Copy to worktree
  - "apps/*/.env"           # Glob supported
  - src: ".env.example"
    dst: ".env"
    mode: copy              # or "symlink"
    when: missing           # or "always"

tasks:
  post_install:
    mode: background        # Async execution
    commands:
      - "npm install"

When to Use

• Working on multiple features in parallel
• Reviewing PRs while continuing other work
• Running long builds/tests on separate branch
• Quick branch switching without stash

Common Mistakes