How do I install the Wm Git Worktree Manager skill?

Run npx skillmds@latest add tomevault-io/wm-git-worktree-manager in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Wm Git Worktree Manager safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Wm Git Worktree Manager?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Wm Git Worktree Manager free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Wm Git Worktree Manager?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Wm Git Worktree Manager by tomevault-io

Name: Wm Git Worktree Manager
Author: tomevault-io

File contents

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

Command	Description
`wm init`	Initialize project config (.wm.yaml)
`wm add <branch>`	Create worktree for branch
`wm add <branch> -p <path>`	Create worktree at custom path
`wm list`	List all worktrees
`wm remove <branch>`	Remove worktree by branch name
`wm remove <path>`	Remove worktree by path
`wm remove -b <branch>`	Remove worktree AND delete branch
`wm remove -f <branch>`	Force remove (skip confirmation)

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

Mistake	Solution
Using interactive mode	Always provide branch/path argument
Expecting nested folders for `feature/auth`	Creates `feature-auth` (flat) since v0.1.1
Trying to remove main worktree	Not allowed - main worktree is protected
Branch used by another worktree	Warning shown, requires confirmation

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: wm-git-worktree-managerdescription: Use when working with git worktrees - creating isolated workspaces for branches, managing multiple features in parallel, or cleaning up worktrees---# WM - Git Worktree ManagerCLI tool for easy git worktree management.## IMPORTANT: Non-Interactive Mode Required**Always use explicit arguments. Interactive mode does not work in automated environments.**```bash# CORRECT - explicit argumentswm add feature-authwm remove feature-auth# WRONG - interactive mode (will hang)wm add # NO!wm remove # NO!```## Quick Reference| Command | Description ||---------|-------------|| `wm init` | Initialize project config (.wm.yaml) || `wm add <branch>` | Create worktree for branch || `wm add <branch> -p <path>` | Create worktree at custom path || `wm list` | List all worktrees || `wm remove <branch>` | Remove worktree by branch name || `wm remove <path>` | Remove worktree by path || `wm remove -b <branch>` | Remove worktree AND delete branch || `wm remove -f <branch>` | Force remove (skip confirmation) |## Common Patterns### Create Worktree```bash# Basic usagewm add feature-login# With custom pathwm add feature-login -p ./workspaces/login# Branch with slash becomes hyphenated folderwm add feature/auth# Creates: ../wm_repo/feature-auth/```### Remove Worktree```bash# By branch namewm remove feature-auth# By pathwm remove ../wm_repo/feature-auth# Also delete the git branchwm remove -b feature-auth# Force (skip confirmation)wm remove -f feature-auth```### List Worktrees```bashwm list# orwm ls```## Configuration (.wm.yaml)```yamlversion: 1worktree: base_dir: "../wm_{repo}" # {repo} replaced with repo namesync: - ".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| Mistake | Solution ||---------|----------|| Using interactive mode | Always provide branch/path argument || Expecting nested folders for `feature/auth` | Creates `feature-auth` (flat) since v0.1.1 || Trying to remove main worktree | Not allowed - main worktree is protected || Branch used by another worktree | Warning shown, requires confirmation |---> Converted and distributed by [TomeVault](https://tomevault.io/claim/devdha) — claim your Tome and manage your conversions.

Frequently asked questions

Wm Git Worktree Manager