Mobile app

The mobile app is a companion to AgentGrid on your computer. It lets you watch a long-running orchestration and send prompts from your phone. It is not a standalone product: it works with computers that are signed in to your AgentGrid account and running AgentGrid. Your phone doesn't need to be on the same network, because it connects through the AgentGrid relay.

What it is

An Expo / React Native app built against the mobile/ workspace, with three build variants:

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

Get the app

The iPhone app is in TestFlight beta, and invites are sent by hand. On your computer, sign in to AgentGrid, open Settings -> Devices, and click Request access on the Get AgentGrid for iPhone card. The invite goes to the email address on your AgentGrid account.

For Android, sign in on the download page and request access with the Google account email on your phone; wait for confirmation before following the installation steps.

Sign in on both devices

1. On your computer, open Settings -> Account and click Sign in to AgentGrid. You finish signing in in your browser.
2. On your phone, open AgentGrid and sign in to the same account with Continue with Apple, Continue with Google, or your email and password.
3. Your computers lists every computer signed in to that account. Tap one that shows Online to connect to it.

There's no QR code or pairing step for your phone. The phone reaches the computer through the AgentGrid relay, so it works away from home too.

When a computer won't connect

Only online computers can connect. Each row on Your computers shows Online, Needs update, Not ready, or Offline, and the phone explains what to fix:

Once your phone is signed in, the Remote Control (AgentGrid app) card in Settings -> Devices on your computer lists it with when it was last seen. When everything is working, the card says "Your phone reaches this computer through the AgentGrid relay."

If something else goes wrong, tap the info button next to the message for details and a link to Diagnostics. Diagnostics stay with the account you're signed in as. Switching accounts does not show or copy the previous account's computer ids and logs.

What you can do once connected

The mobile app mirrors the structure of the computer you're connected to:

• Projects — the projects open on that computer, plus recent ones. Open one to see its Coordinator and team leads. A space with no project opens Coordinator (all), as on the desktop. The phone says a Coordinator is off only when Settings -> Agents on the computer turns it off. In the Teams tree, a lead waiting for your approval reads Waiting for you.
• Tabs list — see every space (tab) on the connected computer.
• 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 add a pane from a mobile subset — a new agent, a terminal, a note, or a title.
• Pane view — open a single pane, stream its terminal output, see queued messages, and send a prompt. You can attach up to four images per message, compressed on-device before they upload. A video from the photo strip, Add files, or Photos on iPhone attaches when that desktop can receive video. An older or disconnected desktop refuses the video and still lets you send text and images. A clip over 5 MB is refused before it is attached. A chip for a single tool stays readable at large text sizes, and loading older messages keeps each reply's name and avatar in place. A message you already sent keeps going for a short time after you leave the app, until the computer has it or iOS ends that window. A sent photo fits its bubble, and a sent video shows a play button and its length, with its first frame when it was attached on the desktop. On Android, the Add context sheet has a Gallery tile that opens the system photo picker. Back from a worker's chat returns to its team lead.

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, image, or video — those need the desktop), and project-folder, role, and .agent-grid/ config management stay on the desktop too.

Share from another app

On iPhone, AgentGrid is in the share sheet. On Android, it is in the Share list when that build of the app is installed. Share a file, photo, text or link, then pick the computer, the project and the conversation. The share waits in that conversation's composer. The chat you already had open does not receive it. The usual attachment limits apply, including four files and 5 MB.

Dictate a prompt

Tap the microphone in a composer to dictate instead of typing. By default, dictation uses AgentGrid's own speech service (Deepgram), and falls back to your computer's Deepgram key when that service is unavailable. To always use your computer's key, choose Desktop's Deepgram key under the phone's Settings -> Dictation. If the phone then says it needs a Deepgram key, open Settings -> Dictation on your computer, click Set API key, and paste your key.

Signing out

Sign out from the phone's Settings tab. Your phone only lists computers signed in to the same AgentGrid account, so signing out disconnects it from all of them.

Related

• Voice mode — voice calls with an agent on the desktop.
• Orchestrating agents — what you're watching on the phone.