worktree

# worktree - Git Worktree Management

## Purpose

Manage parallel development workflows using git worktrees and tmux sessions. Each worktree represents a separate feature branch with its own working directory, and can have its own Claude agent session running in a dedicated tmux window.

**Key Benefits**:
- **Parallel development**: Work on multiple features simultaneously without branch switching
- **Agent orchestration**: Spawn isolated Claude sessions per feature in tmux
- **Progress tracking**: Unified status view of worktrees, agents, and PLAN progress
- **Clean isolation**: Each worktree has its own working directory and agent context

**CLI Tool**: This skill wraps `hy` CLI. Install it first:
- Via `/init` skill (recommended)
- Or manually: `~/.claude/plugins/.../hoyeon/scripts/install-hy.sh`

Once installed, `hy` is available globally in terminal.

---

## Input

```
/worktree <action> [arguments]

actions:
  (no args)                   # Interactive: show status + select → go
  go <name>                   # Go to worktree + run post_command
  create <name>               # Create worktree + move spec from main
  status                      # Show all worktrees with PLAN progress
  path <name>                 # Print worktree path (for scripts)
  cleanup [name]              # Cleanup worktree (interactive if no name)
```

---

## Configuration

This skill references `.dev/config.yml` for project-specific settings. See `${baseDir}/references/config-schema.md` for full schema and examples.

```yaml
worktree:
  base_dir: ".worktrees/{name}"    # Worktree location
  copy_files: [.env.local]         # Files to copy from main
  post_command: "claude"           # Command to run after 'go' (or set HY_POST_COMMAND env)
```

**Defaults**: `base_dir: ".worktrees/{name}"`, `copy_files: []`, `post_command: "claude"`

---

## Actions

### (interactive)

**Purpose**: Interactive mode - show status table and select a worktree to open

**Syntax**:
```
/worktree
hy
```

**Work