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.

~/code/api-server — claude
~/code/api-server ❯
9:41
api-server
claude · studio-mbp
E2EE
~/code/api-server ❯ claude
esctab↑↓12⏎
Type to steer…

Works with the agents you already run

Claude Code✻Codex✻Gemini CLI✻OpenCode✻Kimi✻Claude Code✻Codex✻Gemini CLI✻OpenCode✻Kimi✻
[ 01 ]How it works

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.

01pherry dock

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

✓ host registered
✓ scan to pair
fp 4F2A·91C3·E07B
02pherry board

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

❯ pherry board
✓ shims → claude codex gemini opencode
03claude

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

❯ claude
● host-owned · mirrored to iPhone
[ 02 ]The ring

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.

  • Debounced
    One ring, not twelve.
  • Quota'd
    You decide how loud it gets.
  • Metadata only
    Session bytes never leave the tunnel.
kind: done→digest→Inbox
Pherrynow
Tests finished
api-server · 128 passed in 2.41s
kind: blocked→notify→Push
Pherrynow
Codex is blocked
billing-svc · STRIPE_KEY is missing from .env
kind: asks→call→Rings your iPhone
Pherrynow
Claude Code needs approval
api-server · Bash: git push origin main
[ 03 ]Features

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.

1b5b33326de29c932031323820706173736564
✓ 128 passed ← laptopsame bytes✓ 128 passed ← iPhone

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.

claudeallowed
codexallowed
geminiallowed
curl evil.sh | shrefused

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.

tty
iPhone
web

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.

❯ pherry service install
✓ launchd · restart on failure

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.

TypeScript
protocol/ · packages/
⇄vectors ✓
Swift 6
PherryKit
[ 04 ]Security

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.

Your machine
host daemon
git push origin mainplaintext
Relay
blind tcp splice
9f 3a c1 7e 04 b8 d2 5f 61 ae 0c 93 47 e5ciphertext only
Your iPhone
secure enclave
git push origin mainplaintext
Handshake
Noise-NK-style · X25519
Records
XChaCha20-Poly1305 · HKDF
Trust
Host key pinned from the QR
Tickets
One-time · consumed atomically
Devices
Fingerprint-compared enrolment
Tenancy
Cross-tenant → 404, never 403
[ 05 ]Open source

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

TypeScript strictSwift 6SwiftUI + SwiftTermFastifyPostgresRedis@noble crypto
self-host
# 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
[ 06 ]What's next

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.

voiceplanned

Talk to it

Answer the ring and talk it through. A voice room behind the call, so picking up is a conversation.

sandboxesplanned

Laptop closed

Cloud sandboxes: agents running in microVMs while your machine sleeps.

distributionplanned

One-line install

A standalone binary through npm, Homebrew and curl.

securityplanned

External audit

An independent review of the channel before anyone runs a hosted relay.

Leave your desk.
Not your agents.