All guides

Your agents on your phone

Your agents keep running on your computer. The phone companion lets you reach them when you are away from your desk. Your phone gets a push notification when one needs you. You answer it, pass a review gate, or work through a review with the Companion.

The phone companion is a web app that your computer serves. There is nothing to install from an app store.

1. Turn on remote access

  1. Open Settings → Remote Access.
  2. Turn on Enable remote access.
  3. Under Publish beyond this Mac, choose how the phone reaches your computer. Tailscale Serve is the recommended choice. OpenTunnel is experimental.

Use a choice that gives a stable HTTPS address. Without one, the address changes on every start, and push notifications don’t work.

2. Pair the phone

  1. Under Pair a phone, a QR code shows.
  2. Point the phone’s camera at it and open the link.

The code carries the access key, so treat a photo of it like a password. The key changes every time remote access starts. After a restart, open the app on your phone and use Scan QR code in it to scan the new code.

3. Turn on notifications

On iOS, a page can ask for notifications only once it is on the Home Screen:

  1. In Safari, tap Share → Add to Home Screen.
  2. Open SimpleEdit from the Home Screen icon.
  3. Tap Turn on notifications on the Sessions screen.

You then get a push notification when:

What you can do on the phone

The phone has four tabs: Sessions, Review, My PRs and Backlog.

Speak instead of typing

Where you write to an agent on the phone, there is a 🎤 button next to the text box: a reply to a session, a new session and a backlog item.

  1. Tap 🎤 and speak.
  2. Tap Stop. The words appear in the text box.
  3. Read them, fix what came out wrong, then tap Send (Start for a new session, Save for a backlog item).
A session on the phone while recording, with Stop and ✕ next to the text box The same session after Stop, with the dictated sentence in the text box, ready to send

Nothing is sent until you tap it. Tap ✕ while recording to throw the recording away. If you lock the phone or switch apps while recording, the recording stops and its words still land in the box.

Your computer turns speech into text with whisper.cpp, the same setup the desktop uses. Until it is set up, the phone says “Dictation is off” and you can still type. To set it up, see Talking to your agents.