OpenCode Orchestrator

Multi-Agent Orchestration Plugin for OpenCode

⚡ Quick Start

npm install -g opencode-orchestrator

Then in OpenCode:

/extreme-mission "Implement a Diablo2 Online Game for Web"

🏔️ Extreme Resilience & Performance

Built for "Infinite Missions," the OpenCode Orchestrator is engineered to handle massive codebases and long-running tasks where absolute stability is non-negotiable.

🔄 Continuous Operation (WAL): Mission continuity is guaranteed via Write-Ahead Logging. Even after a system crash, the orchestrator "replays" its history from disk to resume complex tasks exactly where they left off.
⚡ 80% Resource Efficiency: Smart intent-based polling and output caching reduce API overhead by 60-80%. The system intelligently filters redundant traffic, ensuring extreme agility even under heavy multi-agent load.
🧬 Self-Scaling Intelligence: Real-time success/failure feedback dynamic concurrency. The system learns model reliability and rate limits on the fly, autonomously balancing execution speed with fail-safe stability.
💎 Zero-Leak Architecture: Rigorous, lifecycle-based resource management ensures 100% memory reclamation. Engineered for sessions lasting 10,000+ iterations without a single byte of memory drift.

⭐ Core Philosophy

┌───────────────────────────────────────────────────┐
│  🔍 EXPLORE → 📝 LEARN → 🔄 ADAPT → ⚡ ACT         │
│  Scan        Document    Adjust      Execute      │
└───────────────────────────────────────────────────┘

🚀 The Agents

Agent	Role	What It Does
🎯 Commander	Orchestrator	Leads the task, delegates work to other agents, ensures completion
📋 Planner	Researcher	Analyzes the project, creates the plan, documents findings
🔨 Worker	Implementer	Writes code, modifies files, follows the project's patterns
✅ Reviewer	Verifier	Tests changes, checks for errors, confirms quality

📖 Principles

Principle	What It Means
🔍 Never Assume	Always check the actual code and config files first
📝 Document Everything	Record patterns and findings for future tasks
📚 Verify with Evidence	Run tests, cite sources, complete with proof
🔄 Adapt to the Project	Match the project's existing style and patterns
🤝 Specialized Roles	Each agent has a clear, focused responsibility

🏛️ Workflow Architecture

              /extreme-mission "Build REST API"
                          │
          ╔═══════════════════════════════════════╗
          ║     🎯 COMMANDER — Orchestrator       ║
          ║        (Main Session - Single)        ║
          ╚═══════════════════╤═══════════════════╝
                              │
          ┌───────────────────▼───────────────────┐
          │      📋 PLANNER — Create Plan         │
          │         (Single, Sync Call)           │
          │    → Outputs: .opencode/todo.md       │
          └───────────────────┬───────────────────┘
                              │
    ══════════════════════════╧══════════════════════════
    ║                  🔥 PARALLEL ZONE                  ║
    ══════════════════════════════════════════════════════
          │               │               │
          ▼               ▼               ▼
    ┌──────────┐   ┌──────────┐   ┌──────────┐
    │ 🔨 WORKER│   │ 🔨 WORKER│   │ 🔨 WORKER│  ← Up to 50
    │  Task 1  │   │  Task 2  │   │  Task 3  │    concurrent
    │ auth.ts  │   │  api.ts  │   │  db.ts   │    sessions
    └────┬─────┘   └────┬─────┘   └────┬─────┘
         │              │              │
    ══════════════════════════════════════════════════════
    ║                  ⏳ SYNC BARRIER                   ║
    ══════════════════════════════════════════════════════
                              │
          ┌───────────────────▼───────────────────┐
          │      ✅ REVIEWER — Verify All         │
          │         (Single, Sync Call)           │
          │    → Tests, Lint, Integration         │
          └───────────────────┬───────────────────┘
                              │
                    ┌─────────┴─────────┐
                    │   All Complete?   │
                    │   Issues = 0?     │
                    └─────────┬─────────┘
                        No ↙     ↘ Yes
                    ♻️ LOOP    🎖️ MISSION
                   (back to     SEALED
                   Commander)

Execution Model

Phase	Agent	Parallelism	Blocking
1️⃣ Plan	Planner	Single	Sync (waits)
2️⃣ Execute	Workers	Parallel (up to 50)	Async (background)
3️⃣ Verify	Reviewer	Single	Sync (waits)
4️⃣ Loop	Commander	Single	Coordinates

Features

Feature	What It Does
🚀 60-80% Optimization	Smart polling & output caching for massive speed gains
⚡ 50 Parallel Tasks	Run up to 50 agents simultaneously
🔄 Non-Stop Recovery	WAL-based persistence (resumes tasks after crashes)
🔥 Multi-File Ops	Work on different files at the same time
🛡️ Self-Scaling	Dynamic concurrency limits based on success/failure
🩹 Memory Integrity	Strict resource cleanup prevents leaks in long sessions
🧬 Adaptive AI	Agents learn and adapt based on the project

Error Handling

Error	What Happens
💥 Tool crash	Inject recovery prompt and retry
🚦 Rate limit hit	Wait and retry with exponential backoff
📦 Context overflow	Compact the context automatically
⏱️ Session timeout	Resume from the last checkpoint
🔨 Build failure	Fix the issue and retry

📚 Documentation

System Architecture — Full technical deep-dive

🎹 Developer's Words

Read the full note →

📄 License

MIT License. LICENSE