Skip to content
Connected subagent model nodesSubagent Models

Choose models for delegated work

Set one global route or override a single session without changing the primary model.
InstallQuick start

opencode-subagent-models adds global and per-session model selection to OpenCode subagents. Version 0.2.4 keeps the primary session model unchanged and applies a selected reasoning variant only to delegated work.

How selection works

Section titled “How selection works”
  1. A primary session delegates work to a subagent.
  2. The plugin checks the nearest session selection in that branch.
  3. Without a session selection, it uses the global selection.
  4. Default returns control to the next documented scope.

The exact precedence for global state, session state, and Default is in Default and inheritance.

Choose a path

Section titled “Choose a path”
InstallPin the same package version in the server and TUI plugin files.
Make the first selectionChoose a global model, reasoning variant, or one-session exception.
Understand DefaultSee the exact precedence and inheritance rules before combining scopes.
Troubleshoot safelyDiagnose loading and state without exposing prompts, credentials, or configuration.

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.