Remote access
Pair your iPhone with the desktop app, follow a Code task, and use an app on your computer.
Pair your iPhone
Before you begin, set up a private connection on your computer. Remote connects over your local network, ZeroTier, or Tailscale, whichever you’ve set up and Mobile Gateway offers.
- On your computer, open Settings → Mobile Gateway and turn on Enable Mobile Gateway.
- Choose a private connection, then choose Show pairing QR.
- On your iPhone, open the drawer, tap Remote, tap Pair a computer, and scan the code. If the camera can’t read the code, pair manually.
- On your computer, choose Confirm device for the pending device. Your iPhone has no access until you confirm it.
If Mobile Gateway is off, Remote has nothing to connect to. If you haven’t paired a computer, Remote shows No computers yet.
After pairing, filter with All or a computer name, and use Projects view, Priority view, or Search remote chats to find a task.
What stays on your computer
Your iPhone sends requests to your computer. Your computer checks the device’s permissions, does the work, and sends back the result. Your repository, runtime, terminal, and vendor logins stay on your computer. Chat on iPhone doesn’t use this connection, so you can use Chat without a paired computer.
Follow a Code task
Open a task to see its transcript from your computer. From the top bar, you can return to Remote, open the task browser, or open Work surfaces. When the task is idle, use Send message. While it’s running, use Queue message, Steer this turn, or Stop, if your permissions allow. You can send a queued message immediately, edit it, reorder it, or cancel it.
In Work surfaces, Git shows status and diffs, Files shows previews, Agents shows each Agent’s transcript with Message and Stop, and Usage shows the Code usage meter. You can answer approvals from your iPhone if you’ve granted that permission. Staging, committing, pushing, installing runtimes, and using a terminal are available only on your computer.
If you see Waking…, Reconnecting, or Stopped, wake your computer and check the private connection. Then read the transcript before you send again, because your last action may not have reached your computer.
In Mobile Gateway, you can rename a device, change its permissions, revoke one device or all devices, or rotate an identity you’ve lost.
Use an app on your computer
App windows use permissions that are separate from the task browser. On a Mac, macOS also asks you to allow Screen Recording and Accessibility for AI Integrator the first time you connect.
- On your computer, in Mobile Gateway, turn on View app windows for your iPhone. To click and type, also turn on Control app windows. View browser and Control browser don’t include these permissions.
- On your iPhone, tap Browser → New tab, then On your PC.
- Choose an app that’s already open. The list shows each app’s name and window title. The same list is in the tab overview.
The window fills your iPhone screen. Pinch to zoom, and use two fingers to pan and scroll. To type, tap a text field, then tap Show phone keyboard. The button is highlighted when your computer is ready for typing. PC app actions lists the gestures: tap to click, double-tap to double-click, touch and hold to right-click, and drag to drag. Swipe with three fingers to switch to another app or screen.
Close the tab on your iPhone to end the view. The app keeps running on your computer. Restore minimized windows on your computer before you open them. One iPhone can connect at a time, and your iPhone waits while someone is using the computer’s mouse or keyboard. Copy and paste use the computer’s clipboard. You’re controlling the computer’s own pointer. Remote doesn’t create a second desktop or open apps for you.
Elevated apps, the sign-in screen, and some protected windows may not accept input. File drag and drop, app audio, and clipboard sync between your iPhone and your computer aren’t supported.
Control a whole screen
Control screens is a separate permission that covers everything on your computer’s screens, not just one app. Turning on the app window permissions doesn’t turn it on, and turning it on doesn’t turn them on.
When it’s on, On your PC lists Screen 1, Screen 2, and so on, from left to right, with each screen’s resolution. While a screen is live, your computer shows Your phone is controlling this screen with Stop, in a bar that stays on top of other windows. Stop ends every open screen tab. The bar appears only on your computer, not on your iPhone. If you tap where the bar is, it moves to the other end of the screen, and the tap goes to the app underneath. Windows also shows its own capture border.
Screen shortcuts include keys such as Alt+Tab. They don’t send Ctrl+Alt+Del, Win+L, or Mac sign-out shortcuts, and they can’t reach the Windows sign-in screen or the UAC secure desktop. Keep it off unless you want your iPhone to see the whole display.