2.1 KiB
2.1 KiB
Worktree Operations Guide
Detailed step-by-step instructions for each worktree operation.
CREATE Operations
When user wants to create a worktree:
Step 1: Extract information
- Branch name (required) - The git branch to create the worktree from
- Port offset (optional) - Custom port offset, defaults to auto-calculated
Step 2: Invoke command
/create_worktree <branch-name> [port-offset]
Step 3: What happens automatically
The command handles:
- Creates git worktree in
trees/<branch-name> - Configures unique ports (auto-calculated if offset not provided)
- Sets up all environment files (.env, .claude/settings.json)
- Installs dependencies (npm/bun install)
- Starts services in background (server + client)
- Provides access URLs
Step 4: Share results with user
Include:
- Dashboard URL (e.g., http://localhost:5183/dashboard)
- Configured ports (server + client)
- How to access the running services
- Location of worktree directory
LIST Operations
When user wants to see worktrees:
Step 1: Invoke command
/list_worktrees
Step 2: What the command shows
The output includes:
- All existing worktrees with their paths
- Port configuration for each (server + client)
- Service status (running/stopped with PIDs)
- Access URLs for each worktree
- Quick action commands for management
Step 3: Share the overview with user
Highlight:
- Which worktrees are currently running
- How to access each one
- Any issues or conflicts
REMOVE Operations
When user wants to remove a worktree:
Step 1: Extract information
- Branch name (required) - The name of the worktree to remove
Step 2: Invoke command
/remove_worktree <branch-name>
Step 3: What happens automatically
The command handles:
- Stops running services (server + client)
- Kills processes on worktree ports
- Removes git worktree
- Cleans up directories
- Validates complete removal
- Reports success or any issues
Step 4: Confirm removal with user
Share:
- Confirmation that worktree was removed
- Services that were stopped
- Any cleanup actions performed