subtask

Subtask is a CLI skill that integrates with Claude Code to create, manage, and execute multiple tasks concurrently using Git worktrees. Each task runs in its own isolated worktree, enabling safe parallel execution without conflicts. Claude can spawn subagents to work on tasks independently, interrupt them for collaboration, and track real-time progress through a TUI that displays status, diffs, and agent conversations. Tasks are persisted in folders and support both Claude and Codex subagents. This is particularly valuable for operations teams, development leads, and engineering teams managing complex multi-step workflows, code reviews, and feature development cycles.

["Prepare your environment: Ensure Git is installed and you have write permissions to the repository. Install required CLI tools (e.g., `gh` for GitHub CLI if using remote tracking).","Define the parent task: Clearly outline the main objective in [TASK]. Use specific, measurable outcomes (e.g., 'Refactor authentication system to support OAuth2').","Configure parallelism: Set [NUMBER] based on your team's capacity and task complexity. For CPU-bound tasks, use 2-4; for I/O-bound tasks, use 4-8.","Set up tracking: Create a [PROGRESS_FILE_PATH] (e.g., `worktrees/progress-tracker.md`) to log agent assignments, progress, and blockers. Use [WORKTREE_PREFIX] to group related worktrees (e.g., `feature-x`).","Monitor and iterate: Use `git worktree list` to check status. Review the progress file after each agent completes its sub-task. Adjust agent focus areas as needed.","Clean up: After all sub-tasks are complete, run `git worktree prune` to remove stale references. Verify all changes are merged to the main branch before cleanup."]