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:
$ curl -fsSL https://ohrouter.com/install.sh | sh
$ oh-router --version
Or install via Homebrew on macOS and Linux:
$ 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.
$ 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.
$ 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.