← All guides

Mobile app

The Expo/React Native companion that pairs to your desktop so you can watch and prompt agents from your phone.

In this guide

The mobile app is a companion to a paired AgentGrid 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:

VariantDisplay nameScheme
ProductionAgentGridagent-grid
StagingAgentGrid (Stg)agent-grid-staging
DevelopmentAgentGrid (Dev)agent-grid-dev

The bundle ID is sh.agentgrid.mobile (suffixed .dev / .staging for the non-production variants).

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:

  1. On the desktop, open the mobile pairing UI to surface the QR code.
  2. On the phone, open AgentGrid and tap the pair flow (the app's pair.tsx screen). Scan the QR code with your camera.
  3. The desktop mints a agm_* bearer token, persists it locally (sha-256 hashed at rest, file mode 0o600), 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.

Mobile pairing diagram: a running desktop shows a QR code, the pre-release iOS companion scans it on the same local network, and the paired phone can watch and prompt agents.

The pre-release iOS companion pairs with a running desktop on the same local network. Once paired, it can watch and prompt agents.

Diagram by AgentGrid

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, 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 supported agent pane on the phone, tap the call action, and you're in a voice session with that pane — the same one-call-at-a-time invariant as the desktop, driven from your phone.

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 0o600 file mode.
  • Revoking a paired device on the desktop invalidates that device's token; the phone has to re-pair.