Support.

1. Download and launch the free RelayKit Mac helper from schalliol.com/relaykit.

2. In the Mac menu bar, click the RelayKit icon → Pair iPhone. A QR code appears.

3. On your iPhone, open RelayKit and tap Scan Pairing QR. Point at the code.

4. You're paired. Sessions will appear within a few seconds.

RelayKit uses Full Disk Access to read Claude Code's session logs at ~/.claude/projects/, and to cd into project paths inside Dropbox / iCloud Drive / other cloud-sync folders. macOS TCC blocks that kind of read without explicit permission. RelayKit never uploads those contents anywhere — all data stays between your Mac and your paired iPhone, encrypted.

Grant it in System Settings → Privacy & Security → Full Disk Access, toggle RelayKit.app on, relaunch the helper.

No. On the same Wi-Fi / Ethernet, RelayKit discovers your Mac via Bonjour automatically. Tailscale, WireGuard, ZeroTier, or Cloudflare Tunnel are useful when you want to reach your Mac from outside the home network — RelayKit works with any of them, because it connects to a host:port you supply.

• Make sure both devices are on the same network (or the same VPN).
• Open the Mac menu bar item and confirm the helper is "Listening on :47821".
• On iPhone, Settings → RelayKit → make sure Local Network is allowed.
• If you're on a guest network that blocks Bonjour, enter the Mac's IP manually in the Paste Pairing URL flow.

• iPhone Settings → Notifications → RelayKit → allow.
• In the Mac helper menu, confirm Push is enabled and the device is registered (it prints the token to the activity log).
• Push only fires when the app is backgrounded or the device is locked — with RelayKit in the foreground you'll see updates live via the WebSocket.

Most likely you ran claude --resume <id>, which forks into a new session ID. Pull to refresh the list; the forked session will appear below the parent. Fixes to the live-follow behavior are tracked for an upcoming update.

Cookies persist across app restarts but can be cleared by iOS when the app is offloaded or when you delete website data via Safari. Re-authenticate to claude.ai once and it should stick until you manually clear it.

On notched MacBooks, macOS hides menu bar items that don't fit. Use iStat Menus, Bartender, or Apple's built-in System Settings → Control Center → Menu Bar Only Modules reorder to surface it. You can also launch RelayKit actions from Spotlight.

No. There is no RelayKit server — traffic only flows between your iPhone and your paired Mac, encrypted end-to-end with Apple CryptoKit. We collect zero analytics. Details in the privacy policy.

They can't impersonate your phone. Pairing is an X25519 key exchange; every payload is authenticated with ChaCha20-Poly1305 under a per-session key that only your paired iPhone and Mac know. Without the private key in your Keychain, an attacker on the LAN sees only ciphertext.

iPhone: Settings tab inside RelayKit → Unpair. Mac helper: menu bar → Forget Paired iPhone. Either side wipes the keys; the other side re-offers pairing on next connection.

Refunds go through Apple, not us. Visit reportaproblem.apple.com, find RelayKit, and request a refund — Apple almost always approves within 24 hours.

Yes. RelayKit is a one-time purchase tied to your Apple ID. Sign in, redownload from the App Store, pair again.