What problem does it solve?
Coordinate and control multi-agent parallel development across isolated worktrees to reduce manual orchestration, avoid destructive git actions, and streamline merge handoff while preserving runtime isolation and auditability.
Core Features & Use Cases
- Decision framework: mandatory pre-flight checks to determine when parallelization is beneficial and safe.
- Controlled spawning: spawn isolated worktrees using worktree_create with a hard MAX_PARALLEL=4 limit to prevent resource exhaustion.
- Durable dispatch and monitoring: deliver tasks via persisted task files or tmux send-keys, monitor per-branch JSON state files under ~/.local/share/opencode/worktree-state/<project-id>/, and enforce timeouts and cleanup.
- Safe merge handoff: prefer agent self-triggered merges via the merge-agent skill and coordinator fallback using tmux send-keys; avoid duplicating merge internals.
- Failure handling and guardrails: timeout cleanup, preserve failed worktrees for debugging, and strict prohibitions on writing canonical state or implementing agent-to-agent messaging.
Quick Start
Invoke the parallel-dev coordinator with the /parallel-dev trigger to run the decision framework, spawn permitted worktrees, dispatch tasks via task files, monitor state until completion, and trigger merges.
