opencode-orca 🪼

OpenCode plugin for safe and effective agent orchestration.

Requirements

• OpenCode ^1.0.0
• Bun runtime

Features

• Type-enforced contracts - Zod discriminated union validation for all agent messages
• State machine orchestration - IDLE/EXECUTING states with human-in-the-loop gates
• Session continuity - Persistent context between agents via session_id tracking
• Per-agent supervision - Checkpoint protocol for approval gates on sensitive operations

Architecture

User Input
    │
    ▼
  Orca (Orchestrator)
    │
    ├──► Planner (Planning)
    │
    └──► Specialists (Execution)
         ├── Coder
         ├── Tester
         ├── Reviewer
         ├── Researcher
         ├── Document Writer
         └── Architect

Installation

bunx @ex-machina/opencode-orca@latest install

See Getting Started for verification steps and first use.

Configuration

Create .opencode/orca.json to customize behavior:

{
  "settings": {
    "defaultSupervised": false,
    "defaultModel": "anthropic/claude-sonnet-4-20250514"
  },
  "agents": {
    "coder": {
      "supervised": true
    }
  }
}

See Configuration for the full reference.

Documentation

• Getting Started - Quick start guide
• Configuration - Full orca.json reference
• Architecture - System design and decisions
• Custom Agents - Creating custom agents
• Supervision - Checkpoint and HITL model
• Troubleshooting - Common issues

Development

# Install dependencies
bun install

# Build
bun run build

# Watch mode
bun run dev

# Type check
bun run typecheck

# Test
bun test

License

MIT