# 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.

Canonical URL: https://oh.computer/docs

## 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:

**Install OH and spawn a supervised session**

```sh
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](/docs/agents) to install the agent skill, or inspect all subcommands in the [CLI reference](/docs/cli).
