1.1 KiB
1.1 KiB
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:
- Branch name - The git branch for this task (e.g.,
feature/my-task) - 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
- Creates a git worktree at
../<project>-<branch-name> - Creates a tmux session named after the branch
- Launches Claude Code with
--dangerously-skip-permissions - 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.