anomalyco / anomalyco/opencode
Document that --model/-m pins and disables plugin fallback
Open
@neriousy is already working on this.
Since Sep 3, 2026.
- Dominant language
- TypeScript
- Stars
- 209k
- Forks
- 27.5k
- PR merge metrics
- PR metrics pending
Description
Summary
--model / -m pins the session model. Plugin-configured models[] / runtime fallback never runs for that invocation. Reasonable, but undocumented as disables failover, so users who set a backup gateway never see it when they also pass -m.
Repro
- Plugin fallback chain: gateway-a/model then gateway-b/model.
- opencode run -m gateway-a/model --agent sisyphus ping while gateway-a returns 429.
Actual
No hop to gateway-b.
Expected
Document that -m pins and skips fallback. Optionally warn once when -m is combined with a plugin that advertises fallback models.
Suggested fix
Docs plus a single warning. Do not change pin semantics unless maintainers want an opt-in --allow-fallback.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.