OpenCode Orchestrator 🎯

Autonomous Multi-Agent Plugin for OpenCode

What is this?

A 5-agent autonomous architecture designed to solve complex engineering tasks with high reliability, even on mid-range LLMs.

Core Philosophy: Intelligence is a resource. We orchestrate that resource through Phase-based Workflows and Mandatory Environment Scans to ensure code always fits the project's infrastructure.

Key Features

🎯 Autonomous Loop — Commander runs relentlessly until the mission is complete.
🔍 Environment Scan — Mandatory analysis of Infra (Docker/OS), Stack, and Domain before any code change.
🔨 Smart Implementation — Builder matches existing codebase patterns exactly.
🛡️ Rigorous Audit — Inspector proves success with environment-specific evidence (Builds/Tests/Logs).
💾 Persistent Context — Recorder saves session state to disk, enabling resume at any time.
🏗️ Parallel Tasking — Architect splits work into concurrent DAG groups.

Installation

npm install -g opencode-orchestrator

Restart OpenCode after installation.

Usage

Just Select Commander Agent 🎯

Press tab → Select Commander → Type your mission!

"Fix the login bug in the docker-compose environment"

The Commander will:

Survey: Scan the Docker environment and codebase.
Plan: Break the fix into steps.
Execute: Call Builder to fix while matching patterns.
Verify: Run builds/tests to prove the fix works.
Complete: Report results with concrete evidence.

Or Use /task Command

/task "Implement user authentication with JWT"

Agents (5-Agent Architecture)

Agent	Emoji	Role	Responsibility
Commander	🎯	Orchestrator	Autonomous mission control & delegation
Architect	🏗️	Planner	Task decomposition & strategy correction
Builder	🔨	Developer	Full-stack implementation (Logic + UI)
Inspector	🔍	Quality	5-point audit & automatic bug fixing
Recorder	💾	Context	Persistent environment & progress tracking

The Workflow (Progressive Phases)

Phase 0: Triage (Smart)
- Fast Track 🟢: Simple fixes → Execute instantly (Skip heavy scans).
- Deep Track 🔴: Complex features → Full Environment Scan & Plan.
Phase 1: Environment Scan
- Mandatory for Deep Track: Infra/Domain/Stack analysis.
Phase 2: Parallel Planning
- Architect creates a DAG of atomic tasks (Scalable Planning).
Phase 3: Execution & Audit
- Builder writes code ↔ Inspector verifies with evidence.
Phase 4: Completion
- Mission Complete reported with proof of build/test success.

Uninstall

npm run dev:uninstall
# OR
npm uninstall -g opencode-orchestrator

Docs

Architecture & Design — Detailed system design and agent protocols
Plugin Troubleshooting — Setup and common issues

License

MIT License. LICENSE

Reliability over slop. Environment over assumptions.