Package Exports
- opencode-orchestrator
Readme
OpenCode Orchestrator
π Multi-Agent Orchestration Plugin for OpenCode
π₯ Why This Plugin?
Budget models have limits. Orchestration breaks them.
β‘ Quick Start
npm install -g opencode-orchestratorThen in OpenCode:
/task "Build a REST API with authentication"Done. You just deployed an army of AI agents. They plan, build, test, fix β and don't stop until it's sealed. β¨
π― What Makes This Different?
π Core Capabilities
| Feature | What It Means | |
|---|---|---|
| β‘ | Multi-Session Parallel | 50 isolated sessions running simultaneously. True multi-threading. |
| π₯ | Parallel Execution | Workers build different files at once. 10x faster. |
| οΏ½ | Non-Blocking Async | Fire-and-forget. Commander never waits. Results collected automatically. |
| 𧩠| Smart Distribution | One file = one worker. No conflicts. No stepping on each other. |
| π | Real-Time Sync | Shared .opencode/ state. All agents see updates instantly. |
| π‘οΈ | Auto Verify & Test | E2E tests, import checks, integration validation. Bugs get caught. |
| π©Ή | Self-Healing | Auto-recovery from crashes, rate limits, context overflow. 3 retries. |
| οΏ½ | Live Monitoring | Track sessions, progress, queues. Toast notifications in real-time. |
ποΈ How It Works
/task "Build REST API"
β
ββββββββββββββββββββ§βββββββββββββββββββ
β π― COMMANDER β
β Delegate β Loop β
ββββββββββββββββββββ€βββββββββββββββββββ
β
βββββββββββββββββββββββββββββββββΌββββββββββββββββββββββββββββββββ
β β β
βΌ βΌ βΌ
βββββββββββ βββββββββββ βββββββββββ
βπPLANNERβ βπ¨WORKER β βπ¨WORKER β
β plan.md β β auth.ts β β api.ts β
βββββββββββ βββββββββββ βββββββββββ
β β β
β βββββββββββββββββββββββ΄ββββββββββββββββββββββ β
β β π 50 PARALLEL SESSIONS β β
β βββββββββββββββββββββββ¬ββββββββββββββββββββββ β
β β β
βββββββββββββββββββββββββββββββββΌββββββββββββββββββββββββββββββββ
βΌ
ββββββββββββββββββββ§βββββββββββββββββββ
β β
REVIEWER β
ββββββββββββββββββββ€βββββββββββββββββββ
β
ββββββββββββ΄βββββββββββ
β TODO 100%? β
β Issues = 0? β
ββββββββββββ¬βββββββββββ
No β β Yes
β»οΈ LOOP ποΈ SEALEDπ Key Systems
| System | What It Does |
|---|---|
| π Multi-Session | delegate_task β client.session.create() β new isolated session |
| β‘ Parallel Agents | 50 sessions run simultaneously, ConcurrencyController manages slots |
| π₯οΈ Background Tasks | run_background β async shell commands, non-blocking |
| π Auto-Continuation | session.idle β check TODOs β inject prompt β keep going |
| π‘οΈ Self-Healing | Rate limits, crashes β 3 auto-retries per session |
Stop anytime:
/stop
TUI
Window
π§ Self-Healing Features
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β ERROR TYPE β AUTO-RECOVERY ACTION β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Tool crash β Inject recovery prompt β
β Rate limit β Exponential backoff + retry β
β Context overflow β Smart compaction β
β Thinking block error β Auto-restructure β
β Session timeout β Resume from checkpoint β
β Build failure β Loop back, fix, retry β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββπ Documentation
- System Architecture β Full technical deep-dive
Uninstall
npm uninstall -g opencode-orchestratorLicense
MIT License. LICENSE
π v0.9.7 β "Relentless execution until absolute success."
Multi-agent. Parallel. Non-blocking. Self-healing. Enterprise-grade.