Skip to content
Pagr

Documentation

Pagr documentation

Pagr gives the coding agents already running on your Mac a phone number. This is the reference for how that works — the CLI, the bridge, the protocol, and everything you can say in a message.

Start here#

If you have never run Pagr before, the quickstart takes you from an empty terminal to a working thread. It is four commands and one text message.

npm i -g @pagr/clipagr connect

If you want to understand the shape of the thing first — what runs where, and what the cloud is and is not allowed to ask your Mac to do — read the introduction.

Browse the docs#

The short version#

A daemon on your Mac holds one outbound TLS WebSocket to Pagr. It has an Ed25519 key in your macOS Keychain, and it accepts exactly nine typed, signed command types — none of which is “run this command”. When you text, the Pagr control plane works out which of those nine to send. Your Claude and Codex logins never leave the machine, and the cloud never learns a filesystem path.

The daemon and the pagr CLI are open source under Apache-2.0, so the half of Pagr that runs on your computer is the half you can read.