Initial commit

commands/launch.md

@@ -0,0 +1,42 @@
+---
+description: Launch a new background worktree task
+allowed-tools: Bash
+---
+
+# Launch Worktree Task
+
+Launch a background Claude Code session in a separate git worktree to execute a large task autonomously.
+
+## Usage
+
+Provide:
+
+1. **Branch name** - The git branch for this task (e.g., `feature/my-task`)
+2. **Task description** - What the background Claude should do
+
+## Example
+
+User: "Launch a worktree task on branch feature/auth to implement the authentication module"
+
+## Execution
+
+```bash
+python3 ${CLAUDE_PLUGIN_ROOT}/scripts/launch.py "<branch-name>" "<task-description>"
+```
+
+## Prerequisites
+
+- Git working directory must be clean (commit or stash changes first)
+- tmux must be installed
+- Branch name will be created if it doesn't exist
+
+## What Happens
+
+1. Creates a git worktree at `../<project>-<branch-name>`
+2. Creates a tmux session named after the branch
+3. Launches Claude Code with `--dangerously-skip-permissions`
+4. Sends the task prompt with instructions to use Task tool for each phase
+
+## After Launch
+
+Use `/worktree:status` to monitor progress or `tmux attach -t <session>` to take over interactively.