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.

OH Router workspace with Workspace Profiles, 5h and 7d quota meters, model routing ladder, and PolicyAdvisor plugins.
The 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:

OrderTierModel IDProviderClassSmart default effort
1Opusclaude-opus-5-5ClaudestandardHigh (Max when Claude headroom >= 50%)
2Solgpt-6.1-solCodexstandardMax
3Fableclaude-fable-5-2ClaudefrontierMax
4Astragpt-6-astraCodexfrontierMax

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 (Opus and Fable): passes --effort <low|medium|high|max>.
  • Codex (Sol and Astra): 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 in Oh.app and 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.

Manage workspace profiles and routing policy
$ 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