Create Worktree with Environment Setup

When this command is invoked with /create-worktree <branch-name> [base-branch], execute the following steps:

Step 1: Parse Arguments

Extract the branch name and optional base branch from the command arguments.

Step 2: Create Git Worktree

Execute the git worktree add command:

# If base-branch provided:
git worktree add ../{branch-name} -b {branch-name} {base-branch}

# If no base-branch provided:
git worktree add ../{branch-name} -b {branch-name}

The worktree will be created in the parent directory at ../{branch-name}.

Step 3: Identify Source and Target Paths

• Source: Current working directory (the original repo)
• Target: ../{branch-name} (the new worktree)

Step 4: Copy .env Files

Use Bash to check for and copy .env files (gitignored files are not found by Glob):

Check common .env file locations explicitly:

• Top-level: .env
• Frontend: frontend/.env, frontend/.env.local
• Backend: backend/.env, backend/.env.local

For each location, use test -f to check if the file exists, then copy it:

# Check and copy .env files
for env_file in .env backend/.env frontend/.env backend/.env.local frontend/.env.local; do
  if [ -f "$env_file" ]; then
    target_dir=$(dirname "../{branch-name}/$env_file")
    mkdir -p "$target_dir"
    cp "$env_file" "../{branch-name}/$env_file"
    echo "Copied $env_file"
  fi
done

This approach:

1. Checks each known .env location explicitly with test -f
2. Creates target directory if needed with mkdir -p
3. Copies only files that exist
4. Works with gitignored files that Glob cannot see

Step 5: Install Python Dependencies

Check which Python package manager the project uses, then install dependencies in the worktree:

If project uses uv (has pyproject.toml + uv.lock):

• Run uv sync — recreates .venv from the lockfile, no copying needed

# uv projects — run in the worktree backend directory
cd ../{branch-name}/backend
uv sync

If project uses pip (has requirements.txt):

• Copy the existing venv, then run pip install

# Copy venv (all platforms)
cp -r backend/venv ../{branch-name}/backend/venv

# Install dependencies
# Windows
cd ..\{branch-name}\backend && venv\Scripts\python -m pip install -r requirements.txt
# Unix/Mac
cd ../{branch-name}/backend && venv/bin/python -m pip install -r requirements.txt

Check both top-level and backend/ for pyproject.toml/uv.lock or requirements.txt.

Step 7: Install npm Dependencies

Use Glob to find all package.json files in:

• Top-level: package.json
• Frontend: frontend/package.json
• Backend: backend/package.json

For each package.json found:

1. Navigate to the target worktree directory containing the package.json
2. Run npm install

# Windows
cd ..\{branch-name}\frontend
npm install

# Unix/Mac
cd ../{branch-name}/frontend
npm install

Important: Install npm dependencies in ALL directories that have a package.json file (top-level, frontend/, backend/, or any other subdirectories).

Step 8: Report Completion

Provide a summary to the user:

• Worktree created at: ../{branch-name}
• .env files copied: [list]
• Python dependencies installed in: [list] (method: uv sync / pip install)
• npm dependencies installed in: [list]

Platform Detection

Detect the platform using:

# Check if Windows (look for .bat or .ps1 files, or check OS)
uname -s  # Returns "MINGW64_NT" or similar on Windows Git Bash

Use appropriate commands (copy vs cp, robocopy vs cp -r, Scripts vs bin) based on platform.

Error Handling

• If git worktree add fails, stop and report error
• If .env copy fails, warn but continue
• If uv sync / pip install fails, warn but continue
• If npm install fails, warn but continue
• Always report which steps succeeded and which failed

Example Execution

User runs: /create-worktree feature-auth main

Expected output:

Creating worktree 'feature-auth' based on 'main'...
✓ Worktree created at ../feature-auth

Copying .env files...
✓ Copied backend/.env
✓ Copied frontend/.env

Installing Python dependencies...
✓ uv sync in backend/ (recreated .venv from uv.lock)

Installing npm dependencies...
✓ Installed frontend/package.json (127 packages)
✓ Installed backend/package.json (43 packages)

Worktree setup complete! You can now work in ../feature-auth