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-orchestrator

Then 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

                          YOU
                           │
                           │  /task "Build REST API"
                           ▼
    ╔══════════════════════════════════════════════════════════╗
    ║                   🎯 COMMANDER                           ║
    ║            "I orchestrate. I never sleep."               ║
    ╚══════════════════════════════════════════════════════════╝
                           │
          ┌────────────────┼────────────────┐
          │                │                │
          ▼                ▼                ▼
    ┌──────────┐    ┌──────────┐    ┌──────────┐
    │📋 PLANNER│    │🔨 WORKER │    │🔨 WORKER │    x50 PARALLEL
    │  Plan &  │    │ auth.ts  │    │  api.ts  │    SESSIONS
    │ Research │    │  (TDD)   │    │  (TDD)   │
    └──────────┘    └──────────┘    └──────────┘
          │                │                │
          └────────────────┼────────────────┘
                           ▼
    ╔══════════════════════════════════════════════════════════╗
    ║                   ✅ REVIEWER                            ║
    ║         E2E Tests • Sync Check • Validate                ║
    ╚══════════════════════════════════════════════════════════╝
                           │
                    ┌──────┴──────┐
                    │  Complete?  │
                    └──────┬──────┘
                     No ↙     ↘ Yes
                   ♻️           🎖️
                 LOOP         SEALED
              (auto-fix)    (mission done)

🤖 The 4 Agents

Agent	Role	Superpower
🎯 Commander	Orchestrator	Sees everything, delegates intelligently, never stops
📋 Planner	Strategist	Web search, doc caching, file-level task breakdown
🔨 Worker	Builder	TDD isolation, 1 file = 1 session, parallel execution
✅ Reviewer	Quality Gate	E2E tests, sync checks, integration validation

📊 System Specs

Capability	Value
Parallel Sessions	50 simultaneous
Concurrency per Agent	10 default
Poll Interval	1 second
Session TTL	60 minutes
Auto-Recovery	3 attempts per session
Max Iterations	20 per mission
Memory Limit	1,000 tasks (auto GC)

🎮 What Happens When You Run `/task`

🎯 Commander reads state, creates TODO
📋 Planner breaks down into file-level tasks
🔨 Workers build in parallel (50 simultaneous sessions!)
✅ Reviewer validates, runs E2E tests
♻️ Loop until all TODOs checked + zero issues
🎖️ SEALED — mission complete

Tip: Stop anytime with /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-orchestrator

License

MIT License. LICENSE

🚀 v0.9.7 — "Relentless execution until absolute success."

Multi-agent. Parallel. Non-blocking. Self-healing. Enterprise-grade.

opencode-orchestrator