| name | wt-open |
| description | Create or reopen a git worktree for parallel development. Use this whenever the user wants to work on something in parallel, start a new task without disrupting their current branch, spin up an isolated environment for an agent, or mentions worktrees, parallel branches, or "work on X separately". Also triggers for `/wt-open [branch | task description]`. |
| model | sonnet |
| allowed-tools | Bash Read Glob Grep |
| argument-hint | [branch | task description] [--base <branch>] |
Worktree Open
Create or reopen a git worktree for parallel development, then guide the user to launch a Claude Code session in it.
User input: $ARGUMENTS
Step 1 — Parse the user's intent
Determine what the user wants from $ARGUMENTS:
| Input pattern | Action |
|---|
| Empty (no arguments) | Ask the user what they want to work on |
Looks like a branch name (contains /, or starts with feat/, fix/, chore/, refactor/, docs/, ci/, test/) | Use as the branch name directly |
| Natural language (a task description like "add auth to the API") | Derive a branch name (see below) |
Deriving a branch name from a task description
Generate a branch name following this convention:
- Pattern:
<type>/<1-4-word-slug>
- Type:
feat, fix, refactor, chore, docs, ci, test — infer from the description
- Slug: lowercase, hyphen-separated, max 4 words, no special characters
- Examples:
feat/auth-api-refactor, fix/login-timeout, chore/upgrade-deps
Do not ask the user to confirm the branch name, just use it and proceed immediately.
Step 2 — Determine base branch
If the user specified --base <branch> in their arguments, use that.
Otherwise, default to the current branch. If the current branch looks like a feature branch and the user is creating a sub-feature, confirm whether they want to branch from main instead. Use multiple-choice for easy user selection.
Step 3 — Check if this worktree already exists
Run:
git worktree list --porcelain
Derive the expected worktree directory:
REPO_ROOT="$(git rev-parse --show-toplevel)"
SAFE_BRANCH="$(echo "<branch-name>" | tr '/' '-')"
WORKTREE_DIR="${REPO_ROOT}/.claude/worktrees/${SAFE_BRANCH}"
If the worktree directory exists and is valid (has a .git file):
- This is a reopen. Run setup with
--reopen flag (Step 4).
If the branch exists but has no worktree:
- Create a new worktree for the existing branch (Step 4).
If neither exists:
- Create both the branch and worktree (Step 4).
Step 4 — Run the setup script
Verify the setup script exists:
test -f "$(git rev-parse --show-toplevel)/scripts/wt-setup.sh"
If it does NOT exist, tell the user:
Setup script not found at scripts/wt-setup.sh. Run /wt-adopt first to generate it, or install the toolkit with npx @thinkvelta/claude-worktree-tools.
If it exists, run it:
New worktree:
bash "$(git rev-parse --show-toplevel)/scripts/wt-setup.sh" "<branch-name>" --base "<base-branch>"
Reopen existing worktree:
bash "$(git rev-parse --show-toplevel)/scripts/wt-setup.sh" "<branch-name>" --reopen
Step 5 — Print result and next steps
After the setup script completes, print:
Worktree ready!
Branch: <branch-name>
Path: <worktree-path>
Status: new | reopened
To start working in this worktree, navigate to it and launch a Claude Code session or open in VSCode:
cd <worktree-path>
claude # Starts a Claude Code session in this worktree
code # Opens the worktree in a new VSCode window
Design principles
This skill is deterministic — the same branch name always produces the same worktree path and ports, so the user can bookmark URLs and expect consistency. It's also idempotent — running it twice with the same branch reopens rather than duplicates, which means the user never has to worry about accidentally creating a mess.
Git only allows a branch to be checked out in one worktree at a time, so the setup script will refuse if the branch is already in use elsewhere. If that happens, surface the error clearly so the user knows which worktree has it.
If the setup script fails partway through, just report what happened. Don't try to auto-clean — partial state is easier for the user to inspect and fix (via /wt-close) than state that was silently deleted.
