Skip to content
Empryo

Phone app

Drive the chats on your computer from your phone, tablet or watch: iPhone, iPad, Apple Watch and Android. Pair with /remote and get told when a turn is done.

Surfaces8 minutes to read
Copy & share
On this page10 sections

The Empryo app for iPhone, iPad, Apple Watch and Android is in beta. It drives the chats on your computer: the agent still runs there, with your files, keys and settings, and the phone shows each step and sends what you type or say.

It needs iOS 26, watchOS 26 or Android 10 or later. Get the iPhone, iPad and Apple Watch app from the App Store; new builds reach the TestFlight beta first. Android is in closed beta: ask on Discord for an invite.

Pair your phoneLink to this section

  1. On your computer, run /remote in the terminal UI or the desktop app. Empryo shows a QR code. If the terminal window is too small for the code, press o to open it in your browser.
  2. In the Empryo app, tap Scan the code and point the camera at the QR code. If the camera can't see the screen, copy the pairing link with c in the terminal UI or Copy link in the desktop app, send it to the phone, and paste it in the app.
  3. If the phone pairs over the quick link, your computer asks first. Click Allow there, or run /remote allow. Over the Wi-Fi or Tailscale, the phone pairs right away.

On the same Wi-Fi you can skip the code. While /remote is on, the app's home screen lists the computer under Nearby on this Wi-Fi. Tap it, then Pair with the computer, check that the phone and the computer show the same six-digit code, and click Allow on the computer.

No computer yet? Tap Try the demo on the home screen for a scripted chat that runs on the phone alone.

After that, the phone finds your computer on its own. Each link pairs one device, within 10 minutes of /remote. A quick link stays open for 5 minutes.

Choose how the phone reaches your computerLink to this section

/remote offers every way it can: the Wi-Fi, Tailscale and the quick link. To offer only one, use one of these instead:

  • To pair while the phone is on the same Wi-Fi, run /remote wifi.
  • To pair over Tailscale from anywhere, run /remote tailscale. Tailscale must run on the phone and on the computer.
  • To pair from anywhere with no account, run /remote quick. The phone connects through the Empryo relay, and the computer asks before it lets the phone in.

If phones on the Wi-Fi can't reach your computer, see Windows Firewall blocks devices on the Wi-Fi or, for Empryo inside WSL, Nothing on the Wi-Fi reaches Empryo in WSL.

Keep phone access on after you quitLink to this section

Run /remote background and pick Keep phone and computer access on, or type /remote background on. Phone access then keeps running after you quit Empryo, starts again with your computer, and the phone can start work by itself. Pick the other choice, or type /remote background off, to turn it off. In the desktop app, the same switch is Keep remote access on in the Remote access window, and Keep it on in Settings › Remote › This computer.

From a shell, empryo phone on turns on background phone access and prints the pairing code, empryo phone off turns it off and empryo phone status shows it. If the computer refuses to register the background service, the command says "Phone access could not change" with the reason and exits with code 1. On Windows this happens when Empryo runs over SSH, outside a signed-in desktop session. Run the command from a terminal on the computer itself instead.

Keep your computer awakeLink to this section

While phone access is on, Empryo can stop your computer from falling asleep so you can still reach it from your phone. Choose how in Settings › Remote › This computer › Keep this computer awake:

  • For a while (default): the computer stays awake for a set number of minutes (30 unless you change Minutes) after a phone or computer connects, and after the turns it started finish. Every new connection restarts the timer. Once it runs out, the computer sleeps on its normal schedule.
  • Always: the computer never sleeps while phone access is on.
  • Off: the computer sleeps on its normal schedule, even during a turn.

The settings are remoteAwake and remoteAwakeMinutes in the configuration. On Linux, Empryo uses systemd-inhibit. When Linux refuses the sleep lock, which can happen when nobody is signed in at the computer itself, Empryo only blocks idle sleep, so closing the lid still puts the computer to sleep.

Remove a phone or stop phone accessLink to this section

/remote forget removes a paired phone from this computer. /remote stop stops phone access until the next /remote.

Use your phone with another computer's engineLink to this section

While your window uses the engine on another computer, /remote pairs the phone with that computer. See Another computer.

What you can do from the phoneLink to this section

  • Drive any chat. Watch every step, steer a turn while it runs, or queue what comes next. A message sent while the chat compacts waits in the queue and says so. See steering.
  • Edit, rewind or resend. Long-press a prompt to change it, go back to it, or send it again. See checkpoints.
  • Find any chat. The chat list groups chats by project and worktree. Filter by All, Needs you, Working, Done or Idle, sort oldest or newest first, drag to reorder, swipe to close, or close every idle chat at once. The + beside the project switch starts a new chat. Tabs keep the same order as on your computer.
  • See every chat at once. The all-chats button in the chat header, or a pinch on the chat, shows every open chat as a small live card. On a tablet or a wide screen, two chats can sit side by side.
  • Read the thinking. With Show reasoning on in the app's settings, each thought is its own row in the steps. With it off, a finished turn shows one Thought row with its length; tap it to read what the model thought.
  • Answer from anywhere. Questions and approvals come to the phone, with numbered answers.
  • Switch projects. Open any project you have open or used recently on your computer, or start one in the background.
  • See what runs. Engines, under Projects, lists every engine on your computer, what it is doing and which windows hold it. Stop one, or restart the phone's own engine; its chats open again in a fresh one.
  • Pick the model. Choose the model, effort and routing for a chat.
  • Switch accounts. On iPhone, Settings → Accounts lists your subscriptions and API keys with the usage of each. Tap one to make your computer use it. Account names stay hidden until you tap the eye.
  • Follow pull requests. A chat's row shows the pull request it works on, with its state and checks. Tap it to see the chat's pull requests and their merge, checks, reviews and threads. See pull requests.
  • Follow a goal. A goal shows Checking goal while it reviews, and you can change its rounds while it runs.
  • Watch the meter. A running turn shows its tokens, cost and generation time, and they stay right when the app reconnects or reloads the chat.
  • Talk instead of typing. Speak a prompt, or go hands-free so each pause sends. See voice input.
  • Attach pictures. Add a photo or take one with the camera.
  • Run on a schedule. Create and edit routines that run every hour, every day, on weekdays or once a week.
  • See what it made. Screenshots, pages, drawings and PDFs the agent makes in a chat are its artifacts. The stack chip under the composer, or /artifacts, lists them by the prompt that made them; tap one to open it on the phone. Images and videos from a turn also show as tiles under its answer and open full screen.
  • Read diagrams and cards. Mermaid diagrams draw as cards; tap one for full screen. Interactive answers show with native sliders, switches and charts.
  • Check on the computer. Status shows how much memory and CPU Empryo and all apps use, how hot the computer runs and its battery. The heat level is Normal, Warm, Hot (the computer may slow down to cool itself) or Very hot (it is slowing down). On a Mac it is the level macOS reports; on Linux and Windows it comes from the CPU temperature, which is shown too, when the computer reports one.

Know when it is doneLink to this section

When a turn finishes, fails or needs you, the phone gets a notification. A Live Activity shows the running chat on the Lock Screen, in the Dynamic Island and in StandBy, and the Apple Watch shows the same status. The "turn finished" notification is skipped when you used the computer's keyboard or mouse in the last two minutes, since you are already there to see it; failures and questions still come through. Linux needs xprintidle for this check, otherwise every finished turn notifies. Child tabs an agent opened stay quiet unless you turn on notifySubTabs.

Apple Watch and Wear OSLink to this section

The watch talks only to your iPhone, so it works wherever the phone reaches your computer: on Wi-Fi, over Tailscale or through the relay. Tap the mic and speak a prompt; your computer turns it into text, you check it, and it goes to the chat you picked, or steers that chat if it is working. You can also type or scribble instead, pick another chat, stop a chat that is working, and answer a question or approve a step. Models and settings stay on the phone. Wear OS watches do the same through the Android app and use the watch's own speech recognition. Prompts sent from a watch say so on the computer and the phone, and the terminal and desktop show the watch next to the phone while it is connected.

On Android, press and hold an answer, a plan or a summary to select text and copy it. On Android 12 and later, Settings → System colours swaps the world's palette for the colours Android takes from your wallpaper; the world's scenery and status colours stay.

NextLink to this section