gh-ourines-worktree-task-plugin/commands/launch.md

description, allowed-tools

description	allowed-tools
Launch a new background worktree task	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

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.