# Quickstart

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

Canonical URL: https://ohrouter.com/docs/quickstart

## 1. Install on macOS or Linux

Install with the SHA-256 verified shell script, Homebrew, or use the binaries bundled inside [OH for Mac](https://oh.computer). 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**

```sh
curl -fsSL https://ohrouter.com/install.sh | sh
oh-router --version
```

Or install via Homebrew on macOS and Linux:

**Homebrew**

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

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

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