Mobile Access

Happy for iPhone and Android is our Claude Code mobile app, and it shows your Codex, Grok, and Gemini sessions too. Pair it once, and every session on your computer is on your phone, end-to-end encrypted. The agent stays on your machine, with your files and your permission boundary.

Pair your phone with Happy Desktop

Settings → Mobile Access, or during onboarding:

  1. Install Happy from the App Store or Google Play. Desktop shows a QR code for the listing.
  2. Scan the device QR Desktop shows next and approve the computer on the phone. One scan.

An already-linked computer is reused without another scan.

Already using the original Happy CLI? Your account and sessions keep working. Connect Desktop from Settings → Mobile Access; the CLI and Desktop appear on the phone as two machines on the same account.

How the phone sync is encrypted

The phone holds the account's primary key. Content is encrypted on one device and decrypted on another. The relay stores and forwards opaque blobs; it sees that machines and sessions exist and when they were active, not what is in them. Full write-up: Security & Encryption.

What you can do from the phone

  • Send messages, with encrypted images.
  • Answer permission requests and questions. A phone reply is a trusted answer.
  • Stop the turn.
  • Switch model and effort. Change the permission mode.
  • Start a session in a directory. A directory that does not exist becomes a request to create it, never a silent mkdir.
  • Read files and the session's Git changes through the same boundary the agent has.

Troubleshooting mobile access

  • Never delete or reset ~/.happy. It holds history, configuration, and account state.
  • A saved link can be offline; Desktop says "connected" only on live status.
  • A lost phone or a conflicting saved account is a recovery conversation. Keep both sides until you choose.