anomalyco / anomalyco/opencode

Document that --model/-m pins and disables plugin fallback

Open
#47,040 0 comments 0 reactions 1 assignee View on GitHub

@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

  1. Plugin fallback chain: gateway-a/model then gateway-b/model.
  2. 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.