Documentation · Start here
OH Documentation
OH runs on your Mac as Oh.app, the background ohd supervisor daemon, and the bundled oh-router command. Together they supervise Claude Code and Codex sessions, sync @vercel/board tasks, and connect remote machines.
How OH fits together
Oh.app ships as a self-contained Apple Silicon application bundle (computer.oh.app). Every helper binary lives inside Oh.app/Contents/Helpers/, so local supervision works immediately after dragging OH to /Applications.
| Component | Location | Role |
|---|---|---|
Oh.app | /Applications/Oh.app | Native Swift 6 / SwiftUI window (Cmd+1 to Cmd+4), Command+K palette, Needs You inbox (Cmd+U), Menu Bar Extra, and Notification Center coordinator. |
ohd | Oh.app/Contents/Helpers/ohd | Background session supervisor listening on ~/.local/state/oh/ohd/ohd.sock (0600) and ~/.local/state/oh/ohd/events.sock (0600). |
oh-holder | Oh.app/Contents/Helpers/oh-holder | Per-session PTY process holder and 2D virtual terminal parser that keeps sessions alive across app restarts. |
oh-router | Oh.app/Contents/Helpers/oh-router (linked at ~/.local/bin/oh-router) | Command-line interface for spawning, inspecting, steering, switching, and pairing supervised sessions. |
Workspaces and keyboard navigation
Every primary surface in Oh.app has a direct shortcut and is searchable from Cmd+K.
| Shortcut | Action |
|---|---|
Cmd+1 | Open Agents: project-grouped sessions, structured turn diffs, and live PTY view. |
Cmd+2 | Open Board: @vercel/board channels, task lanes, Claim & Route, and threads. |
Cmd+3 | Open Router: workspace profiles, 5h/7d quota meters, tier pins, and PolicyAdvisor plugins. |
Cmd+4 | Open Devices: local and remote hosts, Cloudflare Tunnels, and SSH ProxyCommand recipes. |
Cmd+K | Open the fuzzy Command Palette across sessions, tasks, profiles, devices, and actions. |
Cmd+U / Shift+Cmd+U | Toggle the Needs You popover or jump directly to the next blocked item. |
Cmd+D | Toggle side-by-side Split-Pair view and hand off context between two sessions. |
Cmd+J | Cycle terminal display mode between Split, Full Terminal, and Stream Only. |
Cmd+N / Cmd+R | Create a primary item for the active workspace or sync ohd and Board state now. |
Start your first supervised session
Install OH, link oh-router, and spawn a supervised session from your project folder:
$ brew install --cask hraness/tap/oh
$ oh-router daemon start
$ oh-router spawn --project reader --cwd "$PWD" --tier opus --effort high "Add unit tests for CSV export"
$ oh-router ps --json
Continue to Use with coding agents to install the agent skill, or inspect all subcommands in the CLI reference.