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

🔄 Persistent-Autonomous Engine

The orchestrator is built for uninterrupted survival. Using Self-Healing Rehydration, the system state is synced to disk (.opencode/mission_loop.json). Even if the plugin reloads or the process restarts, the orchestrator automatically resumes missions without losing context or agent roles.

🚀 Zero-Payload Initiation (Turbo Mode)

Leverages the experimental.chat.system.transform hook to inject comprehensive agent instructions on the server side. This reduces initial message size by 90%, slashing latency and preventing payload-related hangs during /task invocation.

⛓️ Deadlock-Free Async Pipeline

A re-engineered execution flow that uses Asynchronous Continuation triggers. By utilizing a fire-and-forget strategy for prompt injections, the system eliminates traditional protocol deadlocks between the plugin hooks and the OpenCode server.

📂 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.

🛠️ Key Innovations

🛡️ Self-Healing Mission Continuity

Survival-first design. The orchestrator cross-checks in-memory state with on-disk artifacts at every step. If the plugin's memory is cleared, it re-activates mission flags and agent instructions automatically upon the next event.

🧠 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) through isolated API channels.

🧩 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.