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.

ComponentLocationRole
Oh.app/Applications/Oh.appNative Swift 6 / SwiftUI window (Cmd+1 to Cmd+4), Command+K palette, Needs You inbox (Cmd+U), Menu Bar Extra, and Notification Center coordinator.
ohdOh.app/Contents/Helpers/ohdBackground session supervisor listening on ~/.local/state/oh/ohd/ohd.sock (0600) and ~/.local/state/oh/ohd/events.sock (0600).
oh-holderOh.app/Contents/Helpers/oh-holderPer-session PTY process holder and 2D virtual terminal parser that keeps sessions alive across app restarts.
oh-routerOh.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.

ShortcutAction
Cmd+1Open Agents: project-grouped sessions, structured turn diffs, and live PTY view.
Cmd+2Open Board: @vercel/board channels, task lanes, Claim & Route, and threads.
Cmd+3Open Router: workspace profiles, 5h/7d quota meters, tier pins, and PolicyAdvisor plugins.
Cmd+4Open Devices: local and remote hosts, Cloudflare Tunnels, and SSH ProxyCommand recipes.
Cmd+KOpen the fuzzy Command Palette across sessions, tasks, profiles, devices, and actions.
Cmd+U / Shift+Cmd+UToggle the Needs You popover or jump directly to the next blocked item.
Cmd+DToggle side-by-side Split-Pair view and hand off context between two sessions.
Cmd+JCycle terminal display mode between Split, Full Terminal, and Stream Only.
Cmd+N / Cmd+RCreate 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:

Install OH and spawn a supervised session
$ 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.