OpenCode Orchestrator

🚀 Multi-Agent Orchestration Plugin for OpenCode

⚡ Quick Start

npm install -g opencode-orchestrator

Then in OpenCode:

/task "Build a REST API with authentication"

🧠 Core Philosophy

Explore → Adapt → Act
Like a human exploring unknown space — never assume, always discover.

Behaves like an astronaut exploring the unknown.
In unfamiliar environments: detect without assuming, adapt to discoveries, act with confidence.

┌───────────────────────────────────────────────────────────┐
│                                                           │
│   🔍 EXPLORE    →    🔄 ADAPT    →    ⚡ ACT             │
│                                                           │
│   Scan the         Adjust to         Execute with        │
│   unknown          what you find     confidence          │
│                                                           │
└───────────────────────────────────────────────────────────┘

Agents & Their Philosophy

Agent	Role	Philosophy
🎯 Commander	Orchestrator	Discover project → Delegate intelligently → Loop until sealed
📋 Planner	Strategist	Research docs → Plan with parallelism → Document findings
🔨 Worker	Implementer	Observe patterns → Learn conventions → Implement with fit
✅ Reviewer	Gatekeeper	Read standards → Run tests → Approve with evidence

Guiding Principles

Principle	Practice
🔍 Discover, Don't Assume	Read `context.md`, detect tech stack, find build/test commands
📚 Evidence Over Memory	Cite docs, run actual commands, complete only with proof
🔄 Adapt to the Project	Match existing patterns, follow discovered conventions
🤝 Separation of Concerns	Each agent does one thing excellently

🏛️ Architecture

            /task "Build REST API"
                     │
     ╔═══════════════╧═══════════════╗
     ║  🎯 COMMANDER — Delegate+Loop ║
     ╚═══════════════╤═══════════════╝
                     │
     ┌───────────────┼───────────────┐
     ▼               ▼               ▼
 ┌───────┐      ┌───────┐      ┌───────┐
 │PLANNER│      │WORKER │      │WORKER │   ← 🔥 50 PARALLEL
 │plan.md│      │auth.ts│      │api.ts │      SESSIONS
 └───────┘      └───────┘      └───────┘
     │               │               │
     └───────────────┼───────────────┘
                     ▼
     ╔═══════════════╧═══════════════╗
     ║      ✅ REVIEWER — Verify     ║
     ╚═══════════════╤═══════════════╝
                     │
            ┌────────┴────────┐
            │ TODO 100%?      │
            │ Issues = 0?     │
            └────────┬────────┘
              No ↙       ↘ Yes
            ♻️ LOOP      🎖️ SEALED

✨ Key Features

Feature	Description
⚡ 50 Parallel Sessions	True multi-threading with isolated contexts
🔥 Parallel File Builds	Workers build different files simultaneously
🧩 Smart Distribution	One file = one worker. No conflicts
🔗 Real-Time Sync	Shared `.opencode/` state across all agents
🛡️ Auto Verification	E2E tests, import checks, integration validation
🩹 Self-Healing	Auto-recovery with 3 retries per session

Self-Healing Details

Error Type	Recovery Action
Tool crash	Inject recovery prompt
Rate limit	Exponential backoff + retry
Context overflow	Smart compaction
Session timeout	Resume from checkpoint
Build failure	Loop back, fix, retry

📸 Screenshots

TUI

Window

📚 Documentation

System Architecture — Full technical deep-dive

🗑️ Uninstall

npm uninstall -g opencode-orchestrator

🎹 Developer's Words

I believe playing the piano is also a form of orchestration.

The harmony of polyphony — multiple voices — and homophony — a single melodic line.

Each voice sings its most beautiful song from its own place, yet when combined, they create one grand, beautiful melody. I believe this structure is no different from AI agents.

📄 License

MIT License. LICENSE