43 lines
1.1 KiB
Markdown
43 lines
1.1 KiB
Markdown
---
|
|
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.
|