Primary navigation

Deployment and configuration

Plugins and connections

Remote connections

Control work on another computer through Remote, or point the ZeroTwo desktop app at projects on an SSH host

Remote connections let another device reach work on a computer running the ZeroTwo desktop app. The computer, called the host, supplies its own projects, files, credentials, plugins and tools, and runs the agent itself. The only controller that works end to end today is the ZeroTwo iOS app; see Remote for the phone side.

What you can do remotely

From a paired iPhone you can start or continue Code threads on the host, follow the streamed response, send follow-ups, and answer approval requests. The host's saved permission settings and per-tool rules apply to these runs, but Plan mode and Goal mode do not carry over from the host's screen.

Before you set up Remote

The host runs the ZeroTwo desktop app, signed in to the same account as the phone, and the phone runs the iOS app. The host must be awake and online while you work. Remote is off until you pair a device or switch Allow connections on. Setup always starts on the host, never on the phone.

Set up Remote

  1. Open the Connections settings

    In the desktop app go to Settings > Connections and stay on the Control this Mac tab. Choose Add, or Get started the first time.

  2. Scan the QR code

    In the pairing dialog, scan the code with the phone. If scanning is not possible, type the nine-character manual code, which expires after five minutes.

  3. Open Remote on the phone

    The host appears in the Remote section of the iOS sidebar once pairing succeeds, and Allow connections is switched on for you.

Connections

The Connections page has three tabs. Control this Mac (shown as Control this device on Windows and Linux) lists the devices that may control the host, with Allow connections, Add, a refresh button and Revoke access for each device. Under Other settings, Keep this Mac awake prevents sleep while the computer is connected to power and remote access is on. Control other devices lists computers you have paired with and whether they are online, and SSH is covered below.

Choose what to connect

Use the computer you already work on, or a machine that stays on if you want continuous access.

Your laptop or desktop

You get your existing projects and setup, but access stops when the computer sleeps, loses its network or the app is closed. Turn on Keep this Mac awake to reduce sleep interruptions.

A dedicated always-on computer

Best for long jobs. Install the repositories, credentials, MCP servers, skills and tools it needs, then pair it like any other host.

What comes from the connected host

Files, shell commands, plugins, MCP servers and local tools all come from the host. A revoked device is refused on its next request. Presence and run updates travel through ZeroTwo's backend, which also expires a pending request after about ten minutes and marks a run failed if its host stays silent for five.

Connect to an SSH host

The SSH tab, marked Beta, reads host aliases from your ~/.ssh/config, tests that each one can be reached, and stores an enable switch. It does not run the agent on the remote machine yet, so it is only a discovery and reachability check. Wildcard and Match entries are skipped, and only one level of Include is followed.

Host devbox
  HostName devbox.example.com
  User you

Hand off a task between locations

In a desktop Code task, the footer menu offers Move task to worktree or Move task to local checkout, and Move to followed by a paired host name. Hosts that have not checked in recently are labelled Offline. If a transfer fails, the source data is kept and Retry transfer appears.

Troubleshooting

You don't see the host on your phone

Check that the desktop app is open and signed in with the same account, Allow connections is on, and the phone is still listed under Settings > Connections. If it is not, pair again.

The remote session disconnects

The host probably slept, lost its network or closed the app. Reopen it, or turn on Keep this Mac awake.

Pairing fails

The code may be invalid, expired or already claimed. Generate a new one with Add and try again.

See also