Documentation · Start here

Quickstart

Install oh-router, start the local ohd supervisor, and spawn your first supervised Claude Code or Codex session in under two minutes.

1. Install on macOS or Linux

Install with the SHA-256 verified shell script, Homebrew, or use the binaries bundled inside OH for Mac. Supported prebuilt targets are aarch64-apple-darwin, x86_64-unknown-linux-gnu, and aarch64-unknown-linux-musl.

Install into ~/.local/bin (or set OH_ROUTER_INSTALL_DIR) with SHA-256 verification:

Shell installer
$ curl -fsSL https://ohrouter.com/install.sh | sh
$ oh-router --version

Or install via Homebrew on macOS and Linux:

Homebrew
$ brew install hraness/tap/oh-router
$ oh-router --version

2. Start ohd and install Claude Code hooks

oh-router auto-starts ohd whenever you run a session command, or you can manage it explicitly. daemon setup-hooks merges lifecycle hooks (UserPromptSubmit, PreToolUse, PostToolUse, Notification, Stop) and the Claude Code 2.1.327+ statusLine bridge into ~/.claude/settings.json while preserving any existing statusLine command via --passthrough.

Start supervisor and configure hooks
$ oh-router daemon start
$ oh-router daemon status
$ oh-router daemon setup-hooks
$ oh-router daemon setup-hooks --write

3. Spawn, inspect, steer, and switch sessions

Use spawn to let oh-router pick the best standard or frontier tier, or use claude and codex shorthands to target a specific provider, model tier, and reasoning effort.

Supervise live sessions
$ oh-router spawn --cwd ~/src/my-app "Implement incremental cache invalidation"
$ oh-router claude --tier opus --effort high "Audit error handling"
$ oh-router codex --tier astra --effort max --headless "Review open diff"
$ oh-router ps --json
$ oh-router inspect term_01a2b3c4d5e6
$ oh-router steer term_01a2b3c4d5e6 "Run cargo test and fix any failures"
$ oh-router switch term_01a2b3c4d5e6 --tier sol --effort max

Coding agents can load the public skill bundle from https://ohrouter.com/integrations/oh-router.json or read skills/oh-router/SKILL.md in the repository.