Repository navigation
Releases
v1.5.0
This release fixes setup when several Locations share one server, and makes the TODO list switch actually turn the feature off.
Install or upgrade with:
opencode plugin add openchoreographer@latestWhat changed for users:
- With several Locations in one server, setting one up no longer tears down another's agents. Agents stop disappearing, the settings panel stays available, and each Location keeps its own registrations.
- The TODO list setting now really disables the feature. With it off, the task tools are not offered to any agent and the orchestrator gets no TODO instruction, instead of only hiding the sidebar panel.
- The setting stays off by default, and the sidebar label now reads TODO list to match.
If you already run one Location per server, only the TODO list change affects you.
v1.4.2
This release makes the plugin lighter and cheaper to run.
Install or upgrade with:
opencode plugin add openchoreographer@latestWhat changed for users:
- Helpers are always available. The on and off switches are gone.
- Helpers work until the task is done. Step limits are gone.
- The planning prompt is shorter and easier to follow, with repeated instructions removed.
- Reviews start with one correctness pass. A second review runs only when you ask for it and the change touches that area.
- Less tool output is kept in context, which lowers token use.
- The task list is hidden until you turn it on.
- Docs and error messages now match the actual behavior.
If you used the old helper switches or step limits, those settings are no longer used.
v1.4.1
This release fixes the broken 1.4.0 install.
Install or upgrade with:
opencode plugin add openchoreographer@latestWhat changed for users:
- Installing is one command again. The plugin brings its own helper definitions and does not need a separate setup step.
- The sidebar and settings panel load correctly instead of failing on a missing package.
- The plugin no longer copies helper files into your OpenCode folders, so manual cleanup and duplicate copies are gone.
- Setup and troubleshooting docs were updated.
If you tried 1.4.0, remove it first, then add this version and restart OpenCode.
v1.4.0
This release makes fallback handling steadier and easier to follow.
Fallback models
A failed model run is now sorted into three kinds: out of credits or a billing problem, a temporary problem, or a permanent problem. Out of credits or a billing problem stops using that model at once, with no retry on it. A temporary problem, such as a rate limit, a server error, a timeout, or a network problem, gets one more try in the same session, two tries in total, waiting 1 second, or following the provider's own hint, never waiting more than 15 seconds. A permanent problem, such as an invalid or unsupported request, stops and shows the error, with no retry and no switch.
If a retry succeeds, the model stays in use but is flagged, so the next fresh failure moves to the fallback at once. If the second try fails, the model is set aside for 5 minutes and the work runs once on the fallback. A set-aside model stays aside for a fixed 5 minutes, where it used to double up to 60 minutes, and then the primary is used again. A successful run no longer clears that 5 minutes. Only time passing or the manual restore clears it, and each new failure restarts the 5 minutes.
This is tracked per model, so one exhausted model affects every subagent that uses it, and one restore clears it for all of them. A subagent picks its model when it starts and is never moved in the middle of a run, and a resumed session is not reassigned. When every fallback is also set aside, the last fallback is still tried once instead of failing. A background subagent that fails inside its own run is not re-run on the fallback, but later subagents use the fallback once the model is set aside. An agent with no fallback now keeps OpenCode's own retry behaviour instead of having it switched off.
Sidebar
A subagent that will use a fallback shows it with a small arrow before the model, in orange. Clicking that model cell once arms switch primary?, and a second click on the same cell brings the primary back for every subagent sharing those models, each to its own primary, while other rows are unaffected, and clicking elsewhere disarms it. If the restore fails, a warning reads Could not restore primary model: server plugin unreachable and the row stays on the fallback.
Status tool
fallback_status now reports whether an agent's primary is flagged and lists models set aside with a reason (quota or retries) and remaining wait in milliseconds, replacing the old backoffMs field.
Install
opencode plugin add openchoreographer
npx openchoreographer --no-plugin
Upgrade
opencode plugin update
npx openchoreographer --force
Full Changelog: v1.3.0...v1.4.0
v1.3.0
This release adds model choice, planner checks, roster controls, and less noise and cost.
Models
Open /choreographer to set models for each subagent.
You can set a primary model and fallback models for each of the 13 subagents.
The all workers row sets all workers at once. The all reviewers row sets all reviewers at once.
The model picker has a live search over the model name, the provider, and the full provider and model. If nothing matches, it shows a message.
Press escape to clear the search. Press escape again to go back.
When you confirm a model, the list keeps your scroll position and row selection.
Choices stay inside the plugin. They do not change your OpenCode settings or agent files.
Roster
Each subagent row has an on/off checkbox. The orchestrator row does not.
Turned off subagents leave the sidebar roster. They cannot be started. Their rules are removed from the orchestrator prompt until you turn them back on.
Max parallel sets how many subagents run at once. Set it from 1 to 8. The default is 4.
Reviews
Three new reviewers check work before it starts. They only read. They make no edits.
reviewer-scope asks if the work should exist at all. It advises BUILD, DEFER, or REJECT.
reviewer-plan reviews the written plan for large work.
reviewer-execution checks the revised plan can be carried out. It returns PASS or BLOCK.
These checks run when work is large or unclear, or when a plan points to files that were not confirmed. Small tasks skip them.
Sidebar
A running subagent row in the sidebar is clickable. It takes you to that child session.
Cost
Long background reports and shell output are trimmed to the same limits as everything else, so a noisy run costs less.
Fixes
Reports that describe a failure, or that contain a credential, still come through whole. That protection now also catches disguised versions.
Review cleanup keeps findings outside the edited file. The wording of a finding can no longer cause other findings to be dropped.
Docs
The docs now have pages for install, overview, agents, delegation, reviews, models, settings and sidebar, diff tool, tools, configuration, cost, development, and troubleshooting.
The README is a short landing page. It links to those pages.
Removed
/orchestrate was removed. It duplicated what the orchestrator agent and /review-panel already do.
Install
opencode plugin add openchoreographernpx openchoreographer --no-pluginUpgrade
opencode plugin updatenpx openchoreographer --forceFull Changelog: v1.2.0...v1.3.0
v1.2.0
Adds designer and writer specialists and improved orchestrator delegation
Added
- designer specialist agent for user flows
- writer specialist agent for docs
- all workers now know each other
Changed
- orchestrator now wont delegate a task on a worker agent that doesn't support the scope
- workers can now reject tasks that is not in their scope and pass it to another worker best for the task
- because workers no know each other they would be able to know that there's a better candidate for the task to solidify the rejection
- orchestrator will now stop and notify the user that both primary and fallback models on a worker is unavailable
Install
opencode plugin add openchoreographernpx openchoreographer --no-pluginUpgrade
opencode plugin updatenpx openchoreographer --forceWhat's Changed
Full Changelog: v1.1.0...v1.2.0
1.1.0
Settings and step budgets
/choreographeropens an in-TUI settings panel for TODO and RUNNING animations, TODO panel visibility, agent roster visibility, and per-agent step budgets.- Step budgets are written to the agent definition files and survive installer upgrades.
--reset-stepsrestores the bundled defaults.
TUI performance
- Streaming deltas no longer refresh the sidebar; structural events are coalesced and status events filtered.
- Memoized roster and model lookups, cheaper animation frames, debounced step writes, and cell-accurate truncation.
Fallback and tooling
- Quota failures returned as completed subagent results now retry on the configured fallback, including agents whose model comes from config.
- Optional
stat: trueon the diff tool returns a patch-free summary. - Token trims in the orchestrator, reviewer, and TODO prompts.
Install
opencode plugin add openchoreographer
npx openchoreographer --no-pluginUpgrade
opencode plugin update
npx openchoreographer --force