parallel-tasks — Claude Code command: what it does, how to install
parallel-tasks pulls task queues from issue trackers and assigns independent items across multiple parallel agents without file conflicts.
no license ★ 1,357 updated 2026-03-01
.claude/commands/parallel-tasks.mdWhat parallel-tasks does
This command connects to task trackers such as Linear, GitHub Issues, or spec-workflow. It checks open items, maps them to agent roles like testing, deployment, backend, or documentation, and launches simultaneous workers through the Task tool.
Concurrency is controlled via --max-agents between 1 and 8, defaulting to 4. Tasks touching the same files run in sequence rather than at the same time to prevent write collisions.
If the Linear MCP server, spec-workflow MCP, or gh CLI authentication is missing, the command stops during preflight validation.
What it helps with
- dispatch pending Linear or GitHub issues to parallel AI workers
- prevent concurrent edits on identical project files
- preview task assignments safely using
--dry-run - sort testing, deployment, and coding work into distinct agent roles
Example prompts for the agent
- /parallel-tasks --system linear --auto-assign --max-agents 3
- /parallel-tasks --system spec-workflow --spec-name core-api --dry-run
- /parallel-tasks --system github --conflict-resolution abort
How to install parallel-tasks
Manually: put the files in place
.claude/commands/parallel-tasks.mdCall it with /parallel-tasks. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/parallel-tasks.mdCall it with /prompts:parallel-tasks. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/parallel-tasks.prompt.mdManually: put the files in place
.gemini/commands/parallel-tasks.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about parallel-tasks
How to install parallel-tasks in Claude Code?
Save the command file to .claude/commands/parallel-tasks.md inside your project root.
What does parallel-tasks do?
It retrieves open items from a task tracker, groups non-overlapping tasks, and deploys multiple Claude Code subagents at the same time.
How are task conflicts handled?
Tasks modifying identical files execute sequentially, while the default --conflict-resolution abort setting stops execution if an unhandled conflict arises.