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.

bash
1# CORRECT - explicit arguments
2wm add feature-auth
3wm remove feature-auth
4
5# WRONG - interactive mode (will hang)
6wm add      # NO!
7wm remove   # NO!

Quick Reference

Common Patterns

Create Worktree

bash
1# Basic usage
2wm add feature-login
3
4# With custom path
5wm add feature-login -p ./workspaces/login
6
7# Branch with slash becomes hyphenated folder
8wm add feature/auth
9# Creates: ../wm_repo/feature-auth/

Remove Worktree

bash
1# By branch name
2wm remove feature-auth
3
4# By path
5wm remove ../wm_repo/feature-auth
6
7# Also delete the git branch
8wm remove -b feature-auth
9
10# Force (skip confirmation)
11wm remove -f feature-auth

List Worktrees

bash
1wm list
2# or
3wm ls

Configuration (.wm.yaml)

yaml
1version: 1
2
3worktree:
4  base_dir: "../wm_{repo}"  # {repo} replaced with repo name
5
6sync:
7  - ".env"                  # Copy to worktree
8  - "apps/*/.env"           # Glob supported
9  - src: ".env.example"
10    dst: ".env"
11    mode: copy              # or "symlink"
12    when: missing           # or "always"
13
14tasks:
15  post_install:
16    mode: background        # Async execution
17    commands:
18      - "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