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.

✨ Key Features

Feature	Description
🤖 4 Specialized Agents	Commander → Planner → Worker → Reviewer, each with distinct roles
⚡ Parallel Execution	Up to 50 concurrent sessions — no waiting, maximum throughput
🔄 Background Tasks	Long-running commands (npm install, tests) run non-blocking
📋 TODO-Driven Completion	Auto-continues until every TODO is checked — never stops halfway
🛡️ Auto-Recovery	Handles errors, rate limits, and session crashes automatically
💾 Memory Safety	Auto GC, disk archiving, 60-min TTL — no memory leaks
🔔 Smart Notifications	Consolidated task toasts with progress tracking

🚀 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

🔑 Key Concepts

Concept	Description
♾️ Infinite Loop	Keeps running until ALL TODOs [x] AND no sync issues
🔧 TDD Isolation	Each Worker = 1 file. Test → Build → Delete test
📂 Shared State	`.opencode/` = single source of truth for all agents
🔄 E2E at End	Integration tests run when TODO nearly complete

🎮 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

Enterprise-scale. Memory-safe. Self-healing. Unlimited.