# 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.

Canonical URL: https://oh.computer/docs/routing

## 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 (`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**

```sh
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
```
