Documentation · Workspaces
Workspace profiles, models, and effort
OH routes sessions strictly across four canonical frontier and standard coding tiers, pairing isolated workspace credential folders with four-step reasoning effort control.
Router workspace (Cmd+3) tracks 5-hour and 7-day quota windows across workspace profiles and runs PolicyAdvisor hooks.Canonical four-model routing ladder
OH never downgrades coding sessions to smaller lightweight models. Every session runs on one of four explicit tiers:
| Order | Tier | Model ID | Provider | Class | Smart default effort |
|---|---|---|---|---|---|
1 | Opus | claude-opus-5-5 | Claude | standard | High (Max when Claude headroom >= 50%) |
2 | Sol | gpt-6.1-sol | Codex | standard | Max |
3 | Fable | claude-fable-5-2 | Claude | frontier | Max |
4 | Astra | gpt-6-astra | Codex | frontier | Max |
Interactive sessions default to Opus when an eligible Claude profile has remaining headroom in both its 5-hour and 7-day windows, and select Sol secondary when Opus is held. New Policy Plugin in OH defaults to the frontier ladder (Fable first, Astra secondary).
Four-step effort control
Both the composer bar (Cmd+1 Agents) and oh-router spawn / oh-router switch accept four effort levels (low, medium, high, max), mapped directly to each CLI's native reasoning flag:
- Claude (
OpusandFable): passes--effort <low|medium|high|max>. - Codex (
SolandAstra): passes-c model_reasoning_effort="<low|medium|high|max>". - Switching a running session's tier or effort (
oh-router switch <id> --tier fable --effort max) updates the composer state inOh.appand preserves session continuity across providers, models, and machines.
Workspace profiles and quota windows
Each workspace profile (default, work, etc.) stores its CLI sign-in state in its own directory and tracks 5-hour (window_5h) and 7-day (window_7d) usage percentages plus Codex device-slot locks.
$ oh-router profiles list --json
$ oh-router profiles add --provider claude --id work --label "Work Seat"
$ oh-router profiles login --provider claude --id work
$ oh-router policy set --interactive-provider claude --headless-provider codex --pin reader=opus