Docs sectionsRemote from your phone
Docs › Devices

Remote from your phone

Pair the Altor app on your phone with your desktop to follow sessions, answer questions and handle approvals when you're away from your machine. Agents keep running on the desktop; disconnecting doesn't stop a session.

Pairing a device

  1. On the desktop: avatar → Mobile remote control → choose permissions for the new device.
  2. The desktop shows a QR code. The code expires after 10 minutes, and each machine can have only one pending request at a time.
  3. On your phone: open the app and scan the code. If you can't scan it, open the pairing link.
  4. The code contains the connection address, a device token and a public key. The token is stored in Keychain (iOS) or Keystore (Android).

Device permissions

The desktop chooses permissions before scanning, and the default is View only. For more, the phone sends Request more access and the desktop must approve it. The desktop can change or revoke permissions at any time under Connected devices.

What your phone can do

  • Overview, session list, chat, parallel plans, diff review and CI.
  • Approvals: answer plan questions, allow or deny commands.
  • Advisor, Explain and Assistant, including creating skills with AI.
  • Usage and cost stats over 7, 30 or 90 days.
When the desktop is offlineYour phone can still view synced data, but it can't send commands, approve anything or create sessions until the machine is back online. If the machine no longer recognizes your phone, you'll need to scan a new code.