Use cases

Short answers to the questions people ask before trying Remote. Each answer comes first; the how-to follows.

By agent: Claude Code · Codex · Grok — then general questions and when Remote doesn't fit.

Claude Code

How do I control Claude Code from my phone?

Run Claude Code inside Herdr on a macOS or Linux computer, pair your phone once with Remote, and open the same live session in the phone's browser. No app or account is needed.

1. Install Remote one of two ways. With the installer (Herdr 0.8 or newer): curl -fsSL https://remote.tmts.ca/install.sh | sh -s -- --origin https://remote.tmts.ca, then remote pair. As a Herdr plugin (Herdr 0.8.2 or newer): herdr plugin install arronKler/pairfob, then run Pairfob: Pair a device.
2. On the phone, open remote.tmts.ca/pair and scan the code, then press Enter on the computer to admit it. See Get started.
3. Open the session. Chat lets you message Claude and read replies; Control shows the terminal with a keypad.

Can I answer Claude Code's approval prompts from my phone?

Yes. When Claude Code shows a numbered approval list, Chat shows a Needs your confirmation card where you pick an option and tap Send choice.

Before sending, the computer checks that the terminal screen has not changed; if it has, the card asks you to choose again. Handle in terminal switches to Control for anything else. See Using the app.

Codex

How do I approve Codex CLI commands while away from my desk?

Run Codex in Herdr and pair your phone with Remote; a waiting Codex session is surfaced under Needs you, and its numbered approval prompt can be answered from the phone.

For alerts when the phone is locked, enable push on the computer (it is off by default); subscribed devices are notified when an agent needs you or finishes. See Notifications.

Can I review what Codex changed before I'm back at the computer?

Yes. Remote shows files, git status and diffs, and you can comment on diff lines and send those comments to the agent.

Open the session, go to its changes, and add comments on the lines you want changed; send them as one message to the agent.

Grok

Can I use Grok CLI from my phone?

Yes, if Grok runs in Herdr. Chat view supports Grok sessions, and Control/Terminal work for any Herdr pane.

Pair as above. Grok also appears in the subscription quota view when its account is signed in on the computer.

General

Do I need Tailscale, SSH, a VPN, or open ports?

No. The computer only dials out to the remote.tmts.ca relay, so nothing on it is reachable from the internet.

After pairing, the session is end-to-end encrypted; the relay forwards ciphertext it cannot read. When a direct path is found the session upgrades to a WebRTC DataChannel, otherwise it stays on the relay. See What the relay cannot see.

Is it peer-to-peer?

Partly. Sessions start through the relay and switch to a direct WebRTC connection when the network allows; the relay remains the fallback.

File uploads need the direct connection; without it the app says Uploads need a direct connection.

Can I send a photo or PDF from my phone to the agent?

Yes. Tap Add attachments, pick a file, photo or camera shot, and Remote inserts its workspace path into your draft.

Uploads run over the direct (P2P) connection. See Upload attachments.

Can one phone reach agents on several computers?

Yes. Pair each computer once and switch between them from the computer name at the top of the session list.

See One phone, several computers.

Does it work on a tablet?

Yes. In a window 720px or wider the session list stays on the left with the session beside it.

A touch tablet keeps swipes, long-press and the keypad; with a hardware keyboard, Enter sends.

When it doesn't fit

When is Remote not a fit?

When your agents don't run in Herdr, when the host computer is Windows, or when the computer can't stay awake and online while you are away.

Remote does not run agents itself and cannot wake a sleeping computer. A Windows machine can still open remote.tmts.ca/pair as a second screen, but the host must be macOS or Linux.

Does it cost anything or need an account?

No. Remote is free and open source (Apache-2.0), and there is no account or email login.

Pairing is a one-time QR scan that you confirm on the computer; each device then keeps its own credential.