OMP Model Roles Demystified

One screen decides which model answers, which model retries, and which model quietly does the cheap work.

The selector, as captured

Six live views of /model. Click a role, a fallback, a provider, a chip, or a key hint inside the screenshot; the panel resolves what that surface writes.

Drag the capture sideways to read the whole 132-column terminal.

The ten roles

Every role, the model it holds in the capture, its retry chain, and the exact flag, environment variable, and config key that set it.

Resolution order

What decides the model for a turn, from run flags down to whether the credentials resolve at all.

Multi-model workflows

The shipped ways two or more models split one session.

Keys & aliases

Every key hint the selector prints, and the config surfaces that refer to roles by name.

Key hints

Alias surfaces

Providers & catalog

The sidebar inventory and the models the capture could actually list. Counts are what the isolated documentation profile could reach, not a price list.

Providers in the sidebar

ProviderModelsState

Models in the capture

ModelContextPer millionRoles

Settings cited

Every setting this page names, with its shipped default straight from the OMP schema.

KeyDefaultValuesDescription