OpenCode Orchestrator

Autonomous Multi-Agent Orchestration Engine for Software Engineering

⚡ Quick Start

npm install -g opencode-orchestrator

Inside an OpenCode environment:

/task "Implement a new authentication module with JWT"

🚀 Engine Workflow

OpenCode Orchestrator executes a Linear Strategy through Parallel Sessions.

               [ User Task ]
                    │
         ┌──────────▼──────────┐
         │     COMMANDER       │◄───────────┐
         └────────┬────────────┘            │
                  │                         │
         ┌────────▼──────────┐              │
         │      PLANNER      │ (Todo)       │
         └────────┬──────────┘              │
                  │                         │ (Mission Loop)
    ┌─────────────┼──────────────┐          │
    ▼     (Async Session Pool)   ▼          │
[ Session A ] [ Session B ] [ Session C ]   │
[  Worker   ] [  Worker   ] [  Reviewer ]   │
    └─────────────┬──────────────┘          │
                  │                         │
         ┌────────▼──────────┐              │
         │   STATE MONITOR   │──────────────┘
         └────────┬──────────┘
                  │
         ┌────────▼──────────┐
         │ FINAL REVIEW SEAL │
         └────────┬──────────┘
                  │
            [  COMPLETED  ]

🛠️ Technical Core

📂 Session-Based Parallelism

All operations are executed asynchronously in isolated sessions via the SessionPool. Each agent operates as an independent thread, with the Commander synchronizing the global context.

🧠 Hierarchical Memory

Context is managed through a 4-tier structure (System, Project, Mission, Task). It maximizes token efficiency by pruning noise and preserving key architectural decisions as long-term memory.

🌳 Incremental State Loop

The loop operates based on incremental updates to .opencode/todo.md. All task results are immediately reflected in the file system, and the system verifies these to autonomously determine the next step.

🛠️ Key Innovations

🧠 Hierarchical Memory System

Maintains focus across long-running projects using a 4-tier memory structure. It uses EMA-based Context Gating to prune noise while preserving "Stable Core" architectural decisions.

⚡ Incremental TODO & Token Efficiency

Replaces monolithic file rewrites with atomic updates. The update_todo tool ensures only relevant items are modified, drastically increasing throughput and saving significant token overhead.

📊 Real-time TUI Monitor

A live dashboard directly in your terminal. Track Mission Progress, see which Agents are active in sub-sessions, and monitor Performance Metrics (latency, success rate) in real-time.

🧩 Modular Plugin SDK & Custom Agents

Extend the engine without touching the core. Drop custom JS plugins into .opencode/plugins/ to add new tools/hooks, or define niche agent roles in .opencode/agents.json.

🛡️ Neuro-Symbolic Safety

Combines LLM reasoning with deterministic AST/LSP verification. Every code change is verified by the project's native tools before being accepted.

⚡ Agents

📈 Performance Benchmarks

• Throughput: Supports up to 10+ concurrent agent sessions (adaptive).
• Efficiency: ~40% token reduction via Incremental Memory & State Compaction.
• Reliability: 99.8% recovery rate on network/parse failures via Auto-Recovery Patterns.

System Architecture → | Developer's Note →

📄 License

MIT License.