Mobile Companion
- Mobile app
- All plans
What it does
The Companion screen (Activity, then Companion) lets you dictate and attach files to the focused desktop agent's composer, ready to review before sending. Sharing photos from another app opens a separate screen: choose the project (the current project is preselected), then an agent or the backlog. Sending to an agent starts it if closed and delivers the photos with your optional instructions. The backlog saves the task and images in your account without requiring a connected desktop. The personal assistant remains an explicit option when available. The Companion also shows live agent status and recent activity.
Where to find it
- Mobile app: Activity tab, then the Companion button at the top of the screen. It is no longer a tab of the bottom bar.
- Photos or a screenshot preview: Share, then AgentsRoom. Choose the project, then the agent or Add to backlog. Other files open the Companion queue.
- Sending to agents requires a connected desktop (see Mobile-Desktop Sync). Saving photos to the backlog requires account sign-in and Internet access.
- On the desktop, the Mobile button of the status bar opens the Pair Mobile App window: how to connect (sign in on the phone, remote access switch), then Your phones, then the store buttons.
Your phones, store versions and updates
- Your phones (desktop, Mobile window) lists every phone that ever connected to this computer: connected ones first with a green dot and "Connected", the others sorted by Last connected: <date>. An offline phone can be removed with the bin icon, then Remove to confirm; this also drops it from the devices approved on this computer. A connected phone cannot be removed. The list stays on this computer only.
- Once a phone is known, the Don't have the app yet? block folds into one line. Each store button (App Store, Google Play) carries a small chip with the latest version live on that store and the day it went live. No chip when the version is unknown.
- When the relay cannot be reached, the window shows Not connected to relay: mobile pairing unavailable. Retrying… with the technical error and the relay address under it (useful to tell a VPN or proxy block from an outage).
- On the phone, at launch, when a newer version is live on its own store, a sheet A new version is available shows the installed and latest versions, three reasons to update, and the notes of the missed versions under What's new. Buttons: Update now (opens the store), Later (asks again after 3 days), Don't show again (final on this phone). A push notification may also remind a phone that stays on an old version.
How to use it
- For the Companion, focus the destination agent on the desktop. Shared photos let you choose another project and agent directly on the phone.
- Dictate: open the Companion screen (Activity, then Companion) and tap the microphone once (Tap to dictate), speak, tap again (Tap to stop). The transcript appears in the desktop composer.
- Attach: tap the paperclip next to the microphone (Add to composer), pick Photo, Video or File. Images are resized and recompressed before sending, so it works on cellular. The file is sent in slices through the relay and lands as an attachment of the composer, whatever its type; the same applies to the Attach sheet of an agent's terminal on the phone (From files, From photos): the file becomes an attachment referenced by its path in the message, never pasted as text into the prompt.
- Share photos: choose AgentsRoom, confirm or change the suggested project, then select an agent or the backlog. Add optional instructions and send. A closed agent starts automatically. On failure, the photos remain available to retry; a partial backlog upload resumes on the same task. Other shared files keep the Companion queue.
Keeping the Companion screen open keeps the phone awake, so it can sit next to the keyboard as a status display.
Settings
Desktop: Settings > Mobile > Notify when the phone connects or disconnects (key phoneConnectionNotifications, account-wide, synced across your computers). Three choices: On (default: a card at the top right with a chime), Silent (the card without sound) and Off (no card). Whatever the choice, a drop shorter than 15 seconds (network change, tunnel) shows nothing: neither "Disconnected" nor "Connected". The connection itself and the status bar indicator are never affected. Each card also carries a Turn off link that opens this setting.
On the phone, the microphone and photo permissions are asked by the system on first use.
On a tablet or an unfolded foldable only, mobile Settings shows a Layout section with two choices: Side by side (default) and Full screen. Its help text: "Side by side shows the project list next to the open project, and the pairing screen next to the sign-in form. Full screen gives every screen the whole width, like on a phone." The choice is local to the device. It is hidden on a phone, where it would change nothing.
Mobile Settings > Account shows the signed-in user, Sign out and Delete account (both only when you signed in on the phone itself, not when the phone merely mirrors the desktop's session). Delete account asks Confirm account deletion? with Schedule deletion / Keep account: the deletion is scheduled 30 days later, the phone signs you out at once (which also drops the desktop pairing), and signing in again before that date cancels it. Quota messages on the phone speak of "your account" rather than naming a tier. On iPhone and iPad, an app version carrying in-app purchase adds an AgentsRoom Pro line to that same Account card, where Pro can be subscribed to and purchases restored: see Apple In-App Purchase. Other mobile settings (search, categories, Restart desktop) are covered in Remote Agent Control and Auto-update.
Agent tools (MCP)
No user-facing MCP tool. Shared photos use the desktop's existing agent startup and delivery services; backlog photos use the existing account task and attachment endpoints.
Providers
All providers, no difference. Dictation and files land in whichever agent is focused, whatever CLI it runs.
Mobile
This is a mobile feature; the desktop side is the composer receiving the text or attachment. Works on iPhone, iPad and Android, paired with a macOS, Windows or Linux desktop.
Signing in on the phone: email and password, or, under OR, Continue with Apple (iPhone and iPad only, shown first; since 2026-09-20 the button is drawn by the app on the same geometry as the Google one, with Apple's logo and wording, and the authorization sheet stays Apple's own) and Continue with Google. One flow serves both the sign-in and the create-account screens: an existing account is signed in, a new one is created. An Apple sign-in may hand the app a private relay email rather than your real address. The same three doors exist on the site and the desktop: see Account Sign-In.
An agent's console on the phone is laid out like the desktop pane: the header carries the task title with the project logo, the role pill, the model pill and the token count; the floating buttons sit at the right (Scroll to top / Scroll to bottom, Fullscreen); the input box takes the whole width with its tools under it. Details in Terminal Keys and the Agent Console.
Large screens: the app is the same on a phone, an iPad or a foldable. On an unfolded foldable it now fills the whole screen instead of a phone-sized column with black bands around it, and an iPad is free to rotate (phones stay in portrait). When the window is wide enough, the Projects tab shows the project list on the left (40 % of the width, never narrower than a phone column nor wider than a fixed cap, since the project needs more room than the list) and the selected project on the right, with no back navigation; when that list pane is narrow, its header drops the AgentsRoom wordmark and keeps the logo so the name of the connected computer stays readable; opening a project from a notification or from the Activity tab lands in that right pane. The pairing screen shows the pairing column on the left and the sign-in, sign-up or password-reset form on the right (the install instructions once you are signed in). An agent's terminal still opens full screen on top. Folding the device back goes back to the one-column phone layout. The bottom tab bar stays at the bottom on tablets, and on every OS it folds away under a project's full-screen screens (an agent console, the preview, media, files, changes, triggers, database) so the console owns the bottom of the window.
Limits
- The Companion needs a focused desktop agent. Shared photos can target a closed agent in an installed project; that agent starts on send. Registry-only projects can receive backlog tasks.
- Dictation has a usage limit on the transcription service (Dictation limit reached).
- A file attached from the phone must stay under 20 MB (File is too large to send (keep it under 20 MB).). A large file needs an up-to-date desktop: an older one answers Update the AgentsRoom desktop app to send a file this large.
- The phone and desktop do not need the same Wi-Fi. Agent deliveries use the end-to-end encrypted relay; backlog task images use account storage.
- Shared files are saved as attachments inside the project's own AgentsRoom folder, which is ignored by git automatically.
Common questions
- Where does my dictated prompt go? Into the composer of the focused desktop agent, not into the terminal. You reread and send it yourself.
- Can I send a screenshot of a mobile bug to an agent? Yes: take the screenshot, Share, AgentsRoom, choose the project and agent, then send. The agent starts automatically if closed. You can choose the backlog instead.
- Does it work offline? Shared photos stay on the sending screen after a failure, for a manual retry. The backlog works while the desktop is offline if Internet access is available. Other files keep the Companion queue and its retry on reconnection.
- Does it work with Codex, Copilot, or only Claude? Any provider: the companion talks to the composer, not to the CLI.
- I attached a JSON or a PDF from my phone and the agent refused the message as too long. Fixed on 2026-09-16: a file attached from the phone, in the Companion or in an agent's terminal, is now sent as an attachment and referenced by its path, so its size never reaches the prompt. Update the mobile app and the desktop app.
- Can I sign in with my Apple ID? Yes, on iPhone and iPad: Continue with Apple on the sign-in and create-account screens. Android offers email and Google. Since 2026-09-20 the site and the desktop offer Apple too, so an account created on the phone with Apple opens everywhere.
- How do I delete my account from the phone? Settings > Account > Delete account, then Schedule deletion. The account is deleted 30 days later; signing in again before then keeps it.
- Can I subscribe to Pro from the app? On iPhone and iPad, yes, on an app version carrying in-app purchase: Settings > Account > AgentsRoom Pro, with Restore purchases on the same sheet. The Android app sells nothing. Quotas are still described as the limits of your account rather than by tier name.
- How do I know my phone app is out of date? The phone offers A new version is available at launch, and on the desktop the store buttons of the Mobile window show the latest version of each store. Don't show again stops the sheet on that phone for good.
- Can I stop the "phone connected / disconnected" notification and its sound on the desktop? Yes: Settings > Mobile > Notify when the phone connects or disconnects, then Silent (no sound) or Off (no card). The Turn off link on the card itself opens that setting. Short reconnections of a few seconds never show a card.
- Where do I see which phones connect to my computer? Status bar > Mobile > Your phones, with the last connection of each. Remove an old phone there once it is offline.
- My Galaxy Fold or Pixel Fold shows the app in a narrow column with black bands. Fixed on 2026-09-16: update the mobile app; the unfolded screen is used in full, with the project list and the project side by side.
Related
- Mobile-Desktop Sync: the pairing and the encrypted channel it relies on.
- Terminal Keys and the Agent Console: the agent console on the phone, its key rail and floating buttons.
- Remote Agent Control: driving the agents themselves from the phone.
- Voice Dictation: the same dictation, from the desktop composer.
- Screenshot to Agent: the desktop way to attach a capture.
- Mobile Offline Mode: what the phone keeps for later when agentsroom.dev itself is unreachable.
- Assistant (personal assistant): the personal assistant, one tap away in the Assistant tab.
- Apple In-App Purchase: subscribing to Pro and restoring purchases from the iPhone or iPad app.