1. Installation

npm install -g opencode-orchestrator

Note: The install hook automatically registers the plugin in opencode.json / opencode.jsonc.

3. Usage

Start a mission inside OpenCode:

/task "Implement feature and verify test suite"

---

2. Configuration

Add or customize in opencode.jsonc:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    [
      "opencode-orchestrator",
      {
        "agentConcurrency": {
          "commander": 1,
          "planner": 10,
          "worker": 10,
          "reviewer": 10
        },
        "missionLoop": {
          "ledger": true,
          "markdownMemory": true
        }
      }
    ]
  ]
}

• Model Inheritance: Subagents inherit the primary agent model unless explicitly configured under agent.<name>.model.
• Context Window Limits: Context usage alerts are measured against the window OpenCode reports for the model in use (a 1M-token model is no longer measured against a 200k default). Set contextMaxTokens (an integer token count) in the plugin options to force one limit for every model.
• Options Schema: Full configuration schema is available in opencode-orchestrator.schema.json.

---

5. Shell Listener (Optional)

For authorized testing environments, a multi-session TCP shell listener TUI is available via the bundled Rust CLI:

orchestrator shell-listener --bind 127.0.0.1 --port 4444

---

Troubleshooting: plugin installed but `/task` is missing

OpenCode reads its global config from one location only (run opencode debug paths to see it under config): $XDG_CONFIG_HOME/opencode, otherwise ~/.config/opencode — on every OS, including Windows. Versions ≤ 1.7.15 of this package mistakenly registered in %APPDATA%\opencode on Windows, which OpenCode never reads. Reinstalling with the current version migrates that stale entry automatically (with a .backup.* copy next to the original).

To diagnose:

opencode debug config | grep -A5 '"plugin"'
opencode debug paths

- If plugin is empty, the registration landed in the wrong file: reinstall this package and restart OpenCode. - If plugin lists this package but commands are still missing, OpenCode may be loading a stale cached copy: reinstalling clears <cache>/opencode/packages/opencode-orchestrator@* automatically. - OPENCODE_CONFIG_DIR, when set, takes precedence over every default location.

To remove the plugin:

npm explore -g opencode-orchestrator -- npm run cleanup:plugin
npm uninstall -g opencode-orchestrator

---