Documentation

AI Agent Remote

Watch and steer the coding agents running in terminals on your own computer from your phone. A small open-source bridge runs next to your terminals and the app talks straight to it: no account, no hosted service, nothing uploaded to us.

Get started in a few minutes

Install the bridge on the Mac or Linux computer where your agents run:

macOS or Linux · install script
curl -fsSL https://crow.sg/apps/ai-agent-remote/install.sh | sh
Homebrew
brew tap crow-tech-pte-ltd/agent-remote-bridge https://github.com/Crow-Tech-Pte-Ltd/agent-remote-bridgebrew install agent-remote-bridge

Both put herdr-remote on your path. The script installs to ~/.local/bin without sudo and checks the download against the release’s SHA-256 checksums.

The script is published on crow.sg from install.sh in the bridge repository, and downloads the kits from its GitHub Releases. To read it before running it: curl -fsSL https://crow.sg/apps/ai-agent-remote/install.sh | less

Terminal
herdr-remote up

Then open AI Agent Remote on a phone on the same Wi-Fi. Your computer appears under On this network; tap it, and type the 6-digit code that pops up on the computer. That’s it. The quickstart walks through each step, including computers without Herdr.

iPhone & iPadComing soon to the App Store
AndroidComing soon
Bridge for macOS & LinuxFree and open source · GitHub

How it fits together

AI Agent Remote

iOS

Android coming soon

TLS pinned to your computer

Bridge

herdr-remote on your

Mac or Linux computer

same user account

Your terminals

Herdr, Orca or plain shells

Claude Code, Codex, …

The phone talks to the bridge on your computer over TLS pinned to that computer’s own certificate, directly on your network or through a relay you run. The bridge drives the terminals as you; your agents and model accounts stay where they are.

The bridge is the herdr-remote program. It reads your terminal workspaces from Herdr (a terminal workspace manager for coding agents), Orca, or from plain shells it runs itself, and serves them to the phones you pair. Your coding agents keep running on the computer with your own accounts; the phone only shows and types into what is already there.

What you can do

See who needs you

Agents waiting for input, finished or working, across every project.

Take the terminal

A live terminal with special keys, sized to your screen while you control it.

Read the conversation

Agent history paged back to the start of the session, with search.

Speak a prompt

Voice notes transcribed on your phone, edited before you send.

Review the changes

Branch, changed files and diffs for each project.

From anywhere

On your Wi-Fi, through your VPN, or through a relay you run.

Attention screen listing an agent that needs input and one that finished
Attention
An agent conversation with earlier messages and tool calls
Agent history

What you need

  • A Mac (Apple silicon or Intel) or a Linux computer (x86-64 or ARM64) that stays awake while you use the phone.
  • Optionally Herdr or Orca. Without them, --backend plain lets the bridge run its own shells.
  • An iPhone or iPad on iOS 17 or later. The app is in testing and coming soon to the App Store; Android is coming soon.
  • Your coding agents (Claude Code, Codex, OpenCode, Gemini CLI and others) installed and signed in on the computer, as you use them today.

Next steps

Quickstart

From download to your first terminal in a few minutes.

Install the bridge

macOS and Linux kits, running it as a service, updating.

Pair a phone

Nearby code or QR invitation, read or control.

Using the app

Attention, projects, terminals, keys, history, voice and changes.

Web console

Settings, pairing and devices in your browser.

Reach it from anywhere

Your VPN, the reverse relay and the home network.

Backends & agents

Herdr, Orca or plain terminals, and the agents recognised.

Security

What protects a connection, and how it compares with SSH.

CLI reference

Every herdr-remote command and flag.

Troubleshooting

Fixes for the common problems, and answers to questions.

WhatsApp