> ## Documentation Index > Fetch the complete documentation index at: https://ade-app.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # iOS companion > Pair the ADE iOS app with your Mac over a live WebSocket and mirror lanes, chats, and PRs in real time — start chats, review and merge PRs, all from your phone. The ADE iOS app is a client for your Mac. It pairs over a live WebSocket and mirrors your lanes, chats, and PRs in real time. Start or continue a chat, review and merge a PR, or browse a lane's diff — from your phone. Your source code never leaves the Mac. The phone is a thin client; the agents run on the desktop runtime. > [card] [Download for iOS](https://testflight.apple.com/join/ZSdJGKPy) > > Install ADE Mobile from TestFlight, then pair it with your Mac. ![Agent chat on the ADE iOS app](https://mintcdn.com/ade-ac1c6011/m_EKJqJVzAE9PL2s/assets/readme/phone.webp?fit=max\&auto=format\&n=m_EKJqJVzAE9PL2s\&q=85\&s=6114c71777a38b667bd488a3b8107477) Chat with agents from your phone ## What mobile is for > [card] Follow active work > > See lanes, chats, PRs, and worker activity update live while you are away from the desktop. > [card] Run agents > > Start a new chat or continue an existing one — the agent runs on the Mac, the transcript streams to your phone. > [card] Review and merge PRs > > Read the diff, CI status, and comments, then merge when it is green — without opening a laptop. > [card] Stay synced > > The same lanes and sessions follow you between desktop, the web client, and the phone over one live connection. ## Pair your phone Pairing links the app to your Mac's runtime with a one-time PIN. Generate the PIN on the desktop (or from the CLI), enter it on the phone, and the app connects. **1. Install ADE Mobile** Open [TestFlight](https://testflight.apple.com/join/ZSdJGKPy) on your iPhone and install ADE Mobile. **2. Generate a PIN on the Mac** Open the desktop **Mobile** control and generate a pairing PIN, or run `ade brain pin generate` from any shell. **3. Enter the PIN on iOS** Open the ADE app on your iPhone and type the PIN to pair with your machine. **4. Confirm the connection** The phone shows your project catalog and current lanes; the desktop lists the device as paired. From here, lanes, chats, and PRs stream live. > [accordion] Pair from the terminal > > The pairing PIN is owned by the machine's ADE brain, so you can manage it without the desktop UI: > > ```bash theme={null} > ade brain pin generate # generate a one-time phone pairing PIN > ade brain pin set 123456 # set an explicit PIN > ade brain pin clear # invalidate the current PIN > ade brain status --text # endpoint, service, and sync state > ``` > > Run `ade brain --help` to see every flag. ## Switch a chat's account **Chat Info** has an account row pinned at its bottom, as on the desktop. It shows the provider logo and the email the chat runs on. Tap it to open **Run this chat on**, which lists your other signed-in accounts and how much room each has left. Picking one moves the chat: the same chat and thread, with the next turn on the new login. The list and the switch go to the machine the chat lives on. A chat on a saved API key or a custom provider shows "API key" or "Custom provider" with no switcher, a viewer device sees the row but cannot switch, and while a turn runs the menu asks you to wait for it to finish. ## Review and merge from anywhere A PR your agents opened shows up on the phone with its diff, CI status, and comments. Read it, leave the work running on the Mac, and merge when it goes green. ## What to expect * The Mac must be running — agents execute on the desktop runtime, and the phone mirrors them. * Connection is a live WebSocket, so lanes, transcripts, and PR state update as they change. No manual refresh. * Network reachability matters. Local Wi-Fi is simplest; a tailnet makes reconnection easy when you leave the house. * Large artifacts and diffs load on demand. * Source and project data stay tied to the paired Mac. The phone holds no checkout. * A machine that runs a beta build shows a **Beta** chip. * Beta iPhone builds go to a separate TestFlight app, **ADE Beta**, with an orange icon ([join the public beta](https://testflight.apple.com/join/SsxDjqbF), [more about ADE Beta](https://ade-app.dev/docs/getting-started/ade-beta.md)). It installs beside the normal app with its own data and pairings, and either app connects to Stable and Beta machines. Web links and the pairing QR from the camera open the normal app; pair ADE Beta with its own scanner. > [!NOTE] > > If the app looks connected but updates do not arrive, check the desktop **Mobile** control first, then confirm both devices can reach each other on the network. > [card] [Pull requests](https://ade-app.dev/docs/tools/pull-requests.md) > > How PRs are created, reviewed, and merged in ADE. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.