Mobile app
The Expo/React Native companion that pairs to your desktop so you can watch and prompt agents from your phone.
The mobile app is a companion to a paired Agent Grid desktop — it lets you watch a long-running orchestration, send prompts, and even start a voice call from your phone. It is not a standalone product; a desktop has to be running on the same network.
What it is
An Expo / React Native app built against the mobile/ workspace, with three build variants:
| Variant | Display name | Scheme |
|---|---|---|
| Production | Agent Grid | agent-grid |
| Staging | Agent Grid (Stg) | agent-grid-staging |
| Development | Agent Grid (Dev) | agent-grid-dev |
The bundle ID is sh.agentgrid.mobile (suffixed .dev / .staging for the non-production variants).
The mobile companion is pre-release. iOS is the shipping target today — distributed through TestFlight while the desktop is still in pre-GA. The codebase declares an Android target as well, but there are no production Android build or submit profiles yet; treat Android as in development and not yet available to end users.
Pairing to a desktop
When the desktop launches, it boots a local mobile-bridge HTTP/WS server alongside the main app. Pairing is a QR-code handshake:
- On the desktop, open the mobile pairing UI to surface the QR code.
- On the phone, open Agent Grid and tap the pair flow (the app's
pair.tsxscreen). Scan the QR code with your camera. - The desktop mints a
agm_*bearer token, persists it locally (sha-256 hashed at rest, file mode0o600), and your phone stores the device-specific token.
After that, the phone is paired to that desktop on this network — re-opening the app reconnects automatically.
The mobile app requires your phone and the desktop to be reachable on the same local network. The iOS build prompts for Local Network permission on first launch — grant it, otherwise the bridge can't be reached.
What you can do once paired
The mobile app mirrors the structure of the desktop you're paired to:
- Tabs list — see every space (tab) on the paired desktop.
- Space view — view a space's panes in canvas mode (pan/zoom, same spatial layout as the desktop) or list mode. The pencil button in the header toggles edit mode: drag a pane to a new position and the desktop canvas updates in real time. Long-press an empty area in canvas mode to spawn a new pane from a mobile subset — Claude, Codex, terminal, note, title.
- Pane view — open a single pane, stream its terminal output, see queued messages, send a prompt (you can attach up to four images per message, compressed on-device before they upload), and use the voice-call adapter for live Claude sessions.
It's still a companion, not the full desktop authoring surface. The mobile spawn menu doesn't expose every pane type (no browser, code editor, source control, Antigravity, image, or video — those need the desktop), and project-folder, role, and .agent-grid/ config management stay on the desktop too.
Voice calls from your phone
The mobile app includes a voice-call adapter against the same Realtime backend the desktop uses. Open a Claude pane on the phone, tap the call action, and you're in a voice session with that pane — same one-call-at-a-time invariant as the desktop, just driven from your phone instead.
See Voice mode for the conversation model — the mobile call surface is the same flow.
Pairing security
- Tokens are minted per device and persisted on the desktop only, sha-256 hashed at rest with
0o600file mode. - Revoking a paired device on the desktop invalidates that device's token; the phone has to re-pair.
Related
- Voice mode — the underlying call model.
- Orchestrating agents — what you're watching on the phone.