Start
Requirements
What has to be true before Pagr can do anything useful. Most of it you already have if you run coding agents locally.
On your Mac#
| Requirement | Why | Check |
|---|---|---|
| macOS | The device key lives in the macOS Keychain and the daemon runs as a launchd agent. There is no Linux or Windows build. | — |
| Node.js 22 or newer | The CLI and daemon are published as an npm package and declare engines.node >= 22. pagr doctor fails the node check below 22. | node -v |
| A writable home directory | Everything local lives under ~/.pagr, created mode 0700. | pagr doctor |
The bridge has three runtime dependencies — ws, zod and @napi-rs/keyring — and no auto-update mechanism.
The coding agents#
Pagr coordinates agents you already have. It does not install, host or resell them, and it never sees your Anthropic or OpenAI credentials. You need at least one of:
| Agent | Install | Authenticate |
|---|---|---|
| Claude Code | npm i -g @anthropic-ai/claude-code | Run claude once and sign in with your own account |
| Codex | npm i -g @openai/codex | codex login |
Both must be reachable on the PATH that the launch agent captured when you ran pagr connect or pagr daemon install. If you install an agent afterwards, re-run pagr daemon install from a shell where which claude works, so the plist picks up the new PATH.
claude --versioncodex --versionpagr statusNetwork#
The bridge needs exactly one thing: outbound TLS on port 443 to the Pagr gateway. It never listens on a port, so no inbound rule, port forward or tunnel is required.
- Corporate proxies that intercept WebSockets will break the connection.
pagr doctordoes a raw TCP connect to the gateway host, so it distinguishes “blocked” from “misconfigured”.
On your phone#
- An iPhone with iMessage.
- A phone number verified on your Pagr account. Linking works by texting a single-use
CONNECTcode from that exact number; a code sent from any other number does not link anything.
Accounts#
- A Pagr account. 7 days free, then $29/mo. Cancel anytime. Payment details are collected at signup — see billing.
- Your own Claude Code and/or Codex subscription. Pagr bills for the control plane only.