2.2 KiB
2.2 KiB
description, allowed-tools
| description | allowed-tools |
|---|---|
| Show help for worktree-task plugin |
Worktree Task Plugin Help
A plugin for managing large coding tasks using git worktrees and background Claude Code sessions.
Commands
| Command | Description |
|---|---|
/worktree-task:launch <task> |
Launch a new background task in a separate worktree |
/worktree-task:status [name] |
Check status of all or specific task |
/worktree-task:resume <name> |
Resume an interrupted task |
/worktree-task:cleanup <name> |
Clean up completed task and worktree |
/worktree-task:merge <branch> |
Merge a feature branch into current branch |
/worktree-task:rebase <branch> |
Rebase current branch onto a feature branch |
/worktree-task:help |
Show this help message |
Quick Start
# 1. Launch a complex task in the background
/worktree-task:launch "Implement user authentication with OAuth2"
# 2. Check progress
/worktree-task:status
# 3. When done, merge the changes
/worktree-task:merge feature-auth
# 4. Clean up
/worktree-task:cleanup feature-auth
How It Works
- Launch creates a git worktree (isolated copy of your repo) and spawns a Claude Code instance in a tmux session
- Monitor via
/worktree-task:statusto see progress, logs, and completion state - Resume if task gets interrupted (rate limits, API errors, network issues)
- Merge/Rebase with automatic conflict resolution powered by Claude
- Cleanup removes the tmux session and worktree when done
Best Practices
- Use for tasks that take 10+ minutes or require extensive changes
- Keep task descriptions clear and specific
- Check status periodically to monitor progress
- Use
--keep-worktreewith cleanup if you want to review changes first
File Locations
- Worktrees: Created in parent directory of your repo (e.g.,
../worktree-task-<name>) - Task prompts:
/tmp/claude_task_prompt.txt(temporary) - Monitor logs:
<plugin-dir>/.monitor_cron.log
Requirements
- macOS (for notifications)
- tmux
- git
- Python 3.8+