Detached PTY holders (oh-holder)
Each session runs inside its own detached oh-holder process over a 0600 Unix domain socket, so live TTYs survive ohd daemon restarts without dropping running commands.
OH Router · oh-router · ohd · oh-holder
oh-router supervises Claude Code and Codex inside detached PTY holders, routes work across four frontier and standard model tiers (Opus, Sol, Fable, Astra), blocks accidental keystrokes into terminal spending dialogs, coordinates @vercel/board tasks, and pairs machines over Cloudflare Tunnel.
$ curl -fsSL https://ohrouter.com/install.sh | sh
$ oh-router --version
Verifies the SHA-256 archive digest before extracting oh-router, ohd, and oh-holder into ~/.local/bin.
$ brew install hraness/tap/oh-router
$ oh-router daemon start
Installs all three binaries (oh-router, ohd, oh-holder) on Apple Silicon macOS and Linuxbrew.
$ oh-router daemon status --json
$ oh-router ps
oh-router, ohd, and oh-holder ship inside OH for Mac and resolve sibling helpers through symlink canonicalization.
Open-source MIT Rust workspace (oh-router, ohd, oh-holder) for macOS and Linux.
oh-vt maintains a live 120x40 ECMA-48 grid with SGR cell attributes and screen_epoch checks so automated steering never confirms paid usage-credit prompts.Four-tier routing & effort
oh-router routes strictly across four full-capability models (Opus, Sol, Fable, Astra) and maps a four-step EffortLevel (low, medium, high, max) across Claude Code and Codex flags.
| Tier | Model ID | Provider | Class | CLI Mapping & Default Effort |
|---|---|---|---|---|
opus | claude-opus-5-5 | claude | standard | claude --model claude-opus-5-5 --effort <level> (high, or max when window headroom >= 50%) |
sol | gpt-6.1-sol | codex | standard | codex -m gpt-6.1-sol -c model_reasoning_effort="<level>" (max) |
fable | claude-fable-5-2 | claude | frontier | claude --model claude-fable-5-2 --effort <level> (max, frontier default) |
astra | gpt-6-astra | codex | frontier | codex -m gpt-6-astra -c model_reasoning_effort="<level>" (max) |
oh-holder)Each session runs inside its own detached oh-holder process over a 0600 Unix domain socket, so live TTYs survive ohd daemon restarts without dropping running commands.
oh-router switch <id> --tier sol --effort max stages recent turn context and continues work across providers, models, and machines.
Each workspace profile separates personal (interactive) and work (headless) directories with independent OS flock leases.
PolicyAdvisor pluginsExecutable stdio JSONL plugins in ~/.config/oh-router/plugins/ advise workspace directory mapping and project tier defaults with optional SHA-256 binary pins.
2D ECMA-48 terminal guard
Raw newline or digit writes into an unparsed PTY can confirm pay-as-you-go upgrade menus when an agent hits a window limit. oh-vt parses every byte from the PTY master before any write reaches the child process.
?1049h) cols x rows cell grids with SGR bold, inverse, foreground color, and wide-character widths.screen_epoch counter whenever display erase, scroll, resize, or alternate-screen transitions alter visible geometry.empty_input_box, permission_prompt, folder_trust_dialog, and limit_dialog states deterministically.session.steer, session.action, session.input, and queue.flush with limit_dialog_blocked while a spending or upgrade prompt is on screen.@vercel/board coordination
oh-board embeds both a native Rust @vercel/board@0.53.0 HTTP client (VbClient) and a zero-dependency local server (EmbeddedVbServer) speaking the same endpoints.
oh-router board connect --mode local) or connect to a hosted board with --mode vercel --url <https-url>.--label tier=sol --label effort=max) and task dependencies (--need <task-id>).oh-router worker --once or oh-router worker --loop to claim ready tasks, spawn routed sessions, renew claim leases, and halt cleanly on 409 claim_lost.oh-board speaks @vercel/board@0.53.0 locally or against a hosted board, renewing task claim leases while oh-router worker supervises execution.Cloudflare Tunnel pairing
Expose ohd only on 127.0.0.1 behind a cloudflared Quick or Named Tunnel using constant-time stream_steer Bearer authentication.
$ oh-router daemon start
$ oh-router devices tunnel-start --scope stream_steer --quick --publish
$ oh-router devices recipe --name build-box --role server --quick
?token= URL query strings with 401 Unauthorized so tokens never leak into proxy or access logs.stream_steer permits session listing, inspection, steering, and dialog actions while forbidding kind: "shell", custom argv, and profile or tunnel changes.oh-router devices tunnel-start pairs cloudflared with a 127.0.0.1 HTTP JSON-RPC bridge using constant-time stream_steer Bearer tokens.