OpenCode Orchestrator plugin
opencode-orchestrator
OpenCode Orchestrator keeps a task alive across turns by storing a mission in the project and calling a planner and reviewer
- 283 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Subagents work with project files and the shell, and the destructive command guard does not replace human review.
Install
- Works in
Manual install
opencode plugin add opencode-orchestratorThen `opencode plugin list`. Remove with `opencode plugin remove opencode-orchestrator`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Subagents work with project files and the shell, and the destructive command guard does not replace human review.
This is third-party code. Review the repository files before installing.
What it does
A plugin for OpenCode 2 that keeps the goal and unfinished work across conversation turns. Mission state lives in the project `.opencode/` directory. Commander drives the task, while Planner, Worker and Reviewer join as helpers through OpenCode's own `subagent` tool. The plugin adds `/task`, `/plan`, `/stop` and `/cancel`, an `update_todo` tool, a guard against destructive shell commands, secret redaction in tool output and a size guard for outgoing messages. Mission updates arrive as a separate message after the conversation so the prompt cache is not invalidated.
Who it is for. OpenCode users whose long tasks stall midway when the context resets or a session restarts.
Good fit when
- A task spans many steps and the agent must resume after a break.
- You want a plan before implementation, without code edits: that is `/plan`.
- A separate reviewer checks the worker's result.
- The agent needs a barrier against `rm -rf` and similar commands.
Not a fit when
- You work in Claude Code or Cursor: the plugin targets OpenCode only.
- You run OpenCode 1: it needs version 2.0.19 or earlier.
- A one-off question needs no mission, and a plain chat is simpler.
Example request
/task "Add pagination to the orders list and run the tests"Limitations
Node.js 24 or newer and OpenCode 2 are required. For OpenCode 1 the README points to version 2.0.19 or earlier. A new `/task` replaces the active mission in the same project and stops the earlier session together with its running subagents. The prompt-cache gain depends on provider, model and other plugins, and the README promises no fixed hit rate. Permissions and delegation limits follow the OpenCode agent configuration. The optional `orchestrator` terminal CLI is installed separately through npm.
How to disable. Run `opencode plugin remove opencode-orchestrator`. Delete the `.opencode/` directory with mission state by hand.
FAQ
How does `/task` differ from `/plan`?
`/task` starts a persisted mission with implementation, while `/plan` only prepares a plan without changes.
How do I remove the timestamp footer in a WebUI?
Set `customRendering: false` in the package options and restart the OpenCode backend.
Can I tune role temperature?
Yes. The `agentTemperatures` option takes exact names: Commander, Planner, Worker, Reviewer.
Is a separate CLI required?
No. The terminal `orchestrator` is optional and installed separately with `npm install -g opencode-orchestrator`.
Where is mission state stored?
In the project `.opencode/` directory. Existing TODO and checklist files stay available to a new mission.
Discussion
No questions or reviews yet.
Related
PluginsA kit that gives OpenCode role-based agents, handoffs, independent review and task state that survives interruptions.
An OpenCode plugin: an orchestrator hands work to six specialists, each on its own model, and merges their results into one answer
An OpenCode plugin that runs a team of parallel agents with separate sessions, a shared task board and messaging
Orchestrator plugin for OpenCode and Codex CLI: multiple agents, hooks, built-in MCPs, ultrawork mode and hash-anchored edits
Agents, skills and templates for structured AI development in OpenCode, Codex and Claude Code: docs, plans, review, checkpoints
An open source coding agent for the terminal and desktop with build and plan modes
README in short
An OpenCode plugin with a continuing mission, four agent presets, destructive command guard and secret redaction.