# Worktree Usage Examples

Real-world examples demonstrating how to handle different worktree management scenarios.

## Example 1: Create a new worktree

**User says:** "Create a worktree for the feature-authentication branch"

**Your action:**
1. Use SlashCommand: `/create_worktree feature-authentication`
2. Share the output showing access URLs and ports

**Result:** New worktree created at `trees/feature-authentication` with services running

**Sample response to user:**
> I've created a new worktree for the `feature-authentication` branch. It's running at:
> - Dashboard: http://localhost:5183/dashboard
> - Server: http://localhost:4010
> - Client: http://localhost:5183

---

## Example 2: Create with specific port offset

**User says:** "Set up a parallel environment on branch hotfix-security with port offset 3"

**Your action:**
1. Use SlashCommand: `/create_worktree hotfix-security 3`
2. Share output (will use ports 4030, 5203)

**Result:** Worktree created with custom ports

**Sample response to user:**
> Created worktree for `hotfix-security` with port offset 3:
> - Server: http://localhost:4030
> - Client: http://localhost:5203

---

## Example 3: List all worktrees

**User says:** "What worktrees do I have?"

**Your action:**
1. Use SlashCommand: `/list_worktrees`
2. Share the comprehensive overview

**Result:** User sees all worktrees with their configuration and status

---

## Example 4: Check worktree status

**User says:** "Show me the status of my worktrees"

**Your action:**
1. Use SlashCommand: `/list_worktrees`
2. Highlight key information: running services, ports in use, access URLs

**Result:** User sees which worktrees are active and their details

**What to highlight:**
- Which services are running vs stopped
- Port conflicts if any
- Quick access URLs
- PIDs of running processes

---

## Example 5: Remove a worktree

**User says:** "Delete the feature-auth worktree"

**Your action:**
1. Use SlashCommand: `/remove_worktree feature-auth`
2. Confirm removal completed

**Result:** Worktree removed, services stopped, directory cleaned up

**Sample response to user:**
> Successfully removed the `feature-auth` worktree:
> - Stopped all running services
> - Cleaned up directories
> - Worktree has been removed

---

## Example 6: Remove with different wording

**User says:** "Clean up the old-branch worktree, I don't need it anymore"

**Your action:**
1. Use SlashCommand: `/remove_worktree old-branch`
2. Share confirmation

**Result:** Worktree removed successfully

**Note:** Recognize variations: "clean up", "don't need", "remove", "delete" all indicate removal.

---

## Example 7: Multiple operations workflow

**User says:** "Show me my worktrees, then create a new one for refactor-api"

**Your action:**
1. Use SlashCommand: `/list_worktrees`
2. Share current worktrees
3. Use SlashCommand: `/create_worktree refactor-api`
4. Share new worktree details

**Result:** User sees existing worktrees, then gets a new one created

**Sample response to user:**
> Here are your current worktrees:
> [list output]
>
> Now creating a new worktree for `refactor-api`...
> [creation output with URLs]

---

## Example 8: Managing parallel environments

**User says:** "I need three worktrees for branches: feature-a, feature-b, and feature-c"

**Your action:**
1. Use SlashCommand: `/create_worktree feature-a`
2. Use SlashCommand: `/create_worktree feature-b`
3. Use SlashCommand: `/create_worktree feature-c`
4. Use SlashCommand: `/list_worktrees` (to show all three)

**Result:** Three parallel worktrees created with unique ports

**Sample response to user:**
> Created three worktrees for parallel development:
>
> 1. **feature-a**
>    - Server: http://localhost:4010
>    - Client: http://localhost:5183
>
> 2. **feature-b**
>    - Server: http://localhost:4020
>    - Client: http://localhost:5193
>
> 3. **feature-c**
>    - Server: http://localhost:4030
>    - Client: http://localhost:5203
>
> All services are running and ready for development!

---

## Pattern Recognition

### Create Keywords
- "create", "new", "setup", "make", "build", "start", "initialize"
- "I need a worktree for..."
- "Set up a parallel environment..."

### List Keywords
- "list", "show", "display", "what", "which", "status", "check", "view"
- "What worktrees do I have?"
- "Show me my environments..."

### Remove Keywords
- "remove", "delete", "cleanup", "destroy", "stop", "kill", "terminate"
- "Clean up the...", "I don't need..."
- "Get rid of...", "Delete the..."