OpenCode Orchestrator

Autonomous multi-agent plugin for OpenCode

⚡ Quick Start

npm install -g opencode-orchestrator

Restart OpenCode after installation. Then:

/task "Build a REST API with authentication"

That's it! The Commander takes over and works until the mission is complete.

💡 Why I Built This

Budget models have limits. Orchestration breaks them.

🎯 What is This?

A multi-agent system that autonomously executes complex tasks from start to finish. Just describe your mission — the Commander handles everything else.

✨ v0.9.4 Highlights

🚀 "Relentless execution until absolute success."

Category	Feature
🛡️ Resilience	Never stops. Auto-pivots Plan↔Search on any error
⚡ Parallelism	50 isolated sessions run simultaneously
🔧 TDD Workers	Each agent works in complete isolation (1 file = 1 worker)
🔄 Sync Integration	Shared `.opencode/` state synchronizes all agents
✅ Stability Checks	TODO + Issue verification before mission seal
🧠 Smart Fixers	Anti-overengineering: simple errors get simple fixes

🚀 How It Works

                    /task "Build REST API"
                              │
                              ▼
             ┌────────────────────────────────┐
             │         🎯 COMMANDER           │
             │  Read state → Delegate → Loop  │
             └────────────────────────────────┘
                              │
      ┌───────────────────────┼───────────────────────┐
      ▼                       ▼                       ▼
 ┌─────────┐            ┌─────────┐            ┌─────────┐
 │ PLANNER │            │ WORKER  │            │ WORKER  │    ⚡ PARALLEL
 │ Plan it │            │ Build A │            │ Build B │       EXECUTION
 └─────────┘            └─────────┘            └─────────┘
      │                       │                       │
      └───────────────────────┼───────────────────────┘
                              ▼
             ┌────────────────────────────────┐
             │         ✅ REVIEWER            │
             │       Verify → Sync            │
             └────────────────────────────────┘
                              │
                   ┌──────────┴──────────┐
                   │  TODO incomplete?   │
                   │  Sync issues?       │
                   └──────────┬──────────┘
                        Yes ↓     ↓ No
                    ♻️ LOOP    🎖️ SEALED

🔑 Core Principles

┌─────────────────────────────────────────────────────────────┐
│  🔒 ISOLATION    │  🔄 SYNC       │  ✅ STABILITY          │
├─────────────────────────────────────────────────────────────┤
│  Each worker     │  Shared state  │  TODO 100% complete    │
│  owns 1 file     │  via .opencode │  + Zero sync issues    │
│  No conflicts    │  Real-time     │  = Mission SEALED      │
└─────────────────────────────────────────────────────────────┘

🎮 Usage

Mode	Trigger	What Happens
Commander Mode 🎯	`/task "mission"`	Full autonomous execution
Chat Mode 💬	Just type normally	Simple Q&A, no automation

Example Commands:

/task "Fix the login bug in docker-compose"
/task "Add dark mode to the entire app"
/task "Refactor the API to TypeScript"

Stop anytime: /stop or /cancel

TUI

Window

---

🤖 The 4 Agents

Agent	Role	Key Actions
Commander 🎯	Orchestrator	Delegates tasks, monitors progress, seals mission
Planner 📋	Research + Plan	Web search, doc caching, TODO creation
Worker 🔨	Implementation	Code writing, file ops, background commands
Reviewer ✅	Quality Control	Verification, TODO updates, context management

📊 Resource Limits

Resource	Limit
Parallel Sessions	50
Tasks in Memory	1,000 (auto GC)
Session TTL	60 min
Recovery Attempts	3 per session
Max Iterations	20 per mission

📚 Documentation

For detailed architecture, directory structure, and internals:

System Architecture — Complete technical documentation
Release Notes — Version history

Uninstall

npm uninstall -g opencode-orchestrator

License

MIT License. LICENSE

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