Your agents can
call you now.
Pherry mirrors Claude Code, Codex and Gemini CLI to your iPhone, byte for byte, end-to-end encrypted. When an agent needs you, your phone rings.
Works with the agents you already run
Three commands. Then go outside.
A small daemon on your machine takes custody of the agent's terminal. Your terminal keeps working exactly as before. It just stops being the only screen.
pherry dockDock your machine
Sign in once, register this machine, and pair your phone with a QR. You compare a fingerprint on both screens, so nothing gets enrolled behind your back.
pherry boardBoard a repo
Install PATH shims for the agents you use. If anything about custody is off, the shim runs the real binary unchanged. A launch can never break.
claudeRun your agent. Leave.
Type your agent like always. It opens in your terminal as usual, and it's already on your phone, encrypted end to end.
When it needs you, it rings.
Agents raise attention when they finish, get stuck, or ask for permission. Pherry debounces it, applies your quotas, and routes it to your inbox, a push, or a real phone call through CallKit. Answer, and you're in the session.
- DebouncedOne ring, not twelve.
- Quota'dYou decide how loud it gets.
- Metadata onlySession bytes never leave the tunnel.
A real terminal. In your pocket.
Not a chat transcript and not a summary. The same session, with the same bytes, steerable from wherever you are.
Byte for byte, not a chat log.
The phone renders the same PTY stream your terminal does: colors, spinners, full-screen TUIs. A headless xterm mirror sends a snapshot on connect, then raw deltas.
Face ID, every session.
Your phone's identity is a P-256 key in the Secure Enclave. Every connect is signed behind Face ID and fails closed if you cancel.
Steer-only from the road.
Your phone can launch only agents on your machine's own allowlist. Arbitrary commands never leave the local socket, and every launch is audited.
Your desk stays yours.
Keep typing on the laptop. The phone is a second, equal viewer of the same session. There's no handoff and no takeover.
Survives reboots.
The daemon installs as a launchd agent on macOS or a systemd user unit on Linux, and keeps your login shell's PATH.
One wire. Two languages.
The protocol, the secure channel, the relay handshake and the PTY codec exist in TypeScript and in Swift. Conformance vectors generated from the TypeScript build keep the two byte-equivalent.
The relay is blind. By design.
The cloud only routes metadata and splices ciphertext. The host's key is pinned from the pairing QR and never fetched from the server, so a compromised relay or control plane can't read, forge, or cross-wire a session.
git push origin mainplaintext9f 3a c1 7e 04 b8 d2 5f 61 ae 0c 93 47 e5ciphertext onlygit push origin mainplaintextMIT licensed. Self-host all of it.
There's no hosted service you have to trust. Run the control plane and the relay yourself: locally with one command, or in production with two Docker images.
# everything on your machine ❯ pnpm install && pnpm -r build ❯ make up ✓ postgres + redis · migrate · seed ✓ control plane :3000 ✓ relay :9443 ✓ dashboard :5173 ❯ pherry dock --api http://127.0.0.1:3000 # tests need no Docker, no APNs, no device ❯ make verify
Pre-release, and moving.
The wire, the channel, the relay, the control plane, the dashboard and the iOS app work today. Here's what comes next.
Talk to it
Answer the ring and talk it through. A voice room behind the call, so picking up is a conversation.
Laptop closed
Cloud sandboxes: agents running in microVMs while your machine sleeps.
One-line install
A standalone binary through npm, Homebrew and curl.
External audit
An independent review of the channel before anyone runs a hosted relay.