Choose models for delegated work
Set one global route or override a single session without changing the primary model.
opencode-subagent-models adds global and per-session model selection to OpenCode subagents. Version 0.2.3 keeps the primary session model unchanged and applies a selected reasoning variant only to delegated work.
How selection works
Section titled “How selection works”- A primary session delegates work to a subagent.
- The plugin checks the nearest session selection in that branch.
- Without a session selection, it uses the global selection.
- Default returns control to the next documented scope.
| Context | Result |
|---|---|
| Primary session | Keeps the model selected by OpenCode. |
| Delegated work with a session override | Uses the nearest session model and variant. |
| Delegated work without a session override | Uses the global selection. |
| Global Default | Uses each subagent’s configured model. |
Choose a path
Section titled “Choose a path”- Install the package in both OpenCode plugin files.
- Make the first selection.
- Understand Default and inheritance before combining scopes.
- Troubleshoot loading or state without exposing private data.
Project boundaries
Section titled “Project boundaries”The plugin does not edit agent files, change the primary model, add telemetry, or make network requests of its own. It supports OpenCode 1.17.18; other versions require the same v1 TUI command bridge.