Skip to main content
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.

Download for iOS

Install ADE Mobile from TestFlight, then pair it with your Mac.
Agent chat on the ADE iOS app

Chat with agents from your phone

​
What mobile is for

Follow active work

See lanes, chats, PRs, and worker activity update live while you are away from the desktop.

Run agents

Start a new chat or continue an existing one — the agent runs on the Mac, the transcript streams to your phone.

Review and merge PRs

Read the diff, CI status, and comments, then merge when it is green — without opening a laptop.

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 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.
The pairing PIN is owned by the machine’s ADE brain, so you can manage it without the desktop UI:
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, more about ADE Beta). 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.
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.

Pull requests

How PRs are created, reviewed, and merged in ADE.