nv-worktree-create

name	nv-worktree-create
description	Create a sibling git worktree and a new branch with the same name, copy local `.env*` files, initialize the enterprise submodule, wire enterprise symlinks, and move the agent into the worktree. Use when the user asks for a worktree, parallel branch checkout, or `/worktree` with a branch name.
disable-model-invocation	true

Create a sibling git worktree

Goal: one name → new branch + sibling worktree at ../<name>, ready to work in.

For git command details and path naming, read nv-worktree-commands. For cleanup, read nv-worktree-cleanup.

Inputs

Input	Required	Default
Branch / worktree name	yes — ask if missing	—
Base ref	no	current HEAD

Use the name as-is for the git branch. Use the sanitized name for the directory (see nv-worktree-commands).

Steps

1. Preflight — from the main repo root:

   • git rev-parse --show-toplevel
   • git worktree list — abort if the target path already exists
   • git status --porcelain — if non-empty, warn that the working tree is dirty and ask the user whether to proceed before creating the worktree

2. Create — always a branch and worktree: