Initial commit

commands/help.md

@@ -0,0 +1,69 @@
+---
+description: Show help for worktree-task plugin
+allowed-tools: ""
+---
+
+# 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
+
+```bash
+# 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
+
+1. **Launch** creates a git worktree (isolated copy of your repo) and spawns a Claude Code instance in a tmux session
+2. **Monitor** via `/worktree-task:status` to see progress, logs, and completion state
+3. **Resume** if task gets interrupted (rate limits, API errors, network issues)
+4. **Merge/Rebase** with automatic conflict resolution powered by Claude
+5. **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-worktree` with 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+
+
+## Links
+
+- GitHub: https://github.com/ourines/worktree-task-plugin
+- Issues: https://github.com/ourines/worktree-task-plugin/issues