# AI Agent Remote > Install the open-source bridge, pair your phone and watch or control the coding agents running in terminals on your own computer. Source: https://crow.sg/apps/ai-agent-remote/docs/ 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: ```sh title="macOS or Linux · install script" curl -fsSL https://crow.sg/apps/ai-agent-remote/install.sh | sh ``` ```sh title="Homebrew" brew tap crow-tech-pte-ltd/agent-remote-bridge https://github.com/Crow-Tech-Pte-Ltd/agent-remote-bridge brew install agent-remote-bridge ``` Both put `agent-remote` on your path. The script installs to `~/.local/bin` without sudo, checks the download against the release’s SHA-256 checksums and, if `~/.local/bin` isn’t on your `PATH` yet, adds it to your shell’s startup file (`~/.zshrc` on a Mac); open a new terminal window afterwards. Set `AGENT_REMOTE_NO_MODIFY_PATH=1` to leave your shell files alone. The script is published on crow.sg from `install.sh` in the [bridge repository](https://github.com/Crow-Tech-Pte-Ltd/agent-remote-bridge), 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` ```sh agent-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](https://crow.sg/apps/ai-agent-remote/docs/quickstart/) walks through each step, including computers without Herdr. - **iPhone & iPad:** Coming soon to the App Store - **Android:** Coming soon - **Bridge for macOS & Linux:** [Free and open source · GitHub](https://github.com/Crow-Tech-Pte-Ltd/agent-remote-bridge/releases/latest) ## How it fits together Phone (AI Agent Remote) → TLS pinned to your computer → bridge (`agent-remote` on your Mac or Linux computer) → same user account → your terminals (Herdr, Orca or plain shells running 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 `agent-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](https://crow.sg/apps/ai-agent-remote/docs/app-attention.webp "Attention") ![An agent conversation with earlier messages and tool calls](https://crow.sg/apps/ai-agent-remote/docs/app-history.webp "Agent history") ![Changes view with branch, ahead and behind counts and changed files](https://crow.sg/apps/ai-agent-remote/docs/app-changes.webp "Changes") ## 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](https://crow.sg/apps/ai-agent-remote/docs/backends/#agents)) installed and signed in on the computer, as you use them today. ## Next steps - [Quickstart](https://crow.sg/apps/ai-agent-remote/docs/quickstart/): From download to your first terminal in a few minutes. - [Set up with an AI agent](https://crow.sg/apps/ai-agent-remote/docs/ai-setup/): A ready-to-paste prompt that lets a coding agent install and pair the bridge with you. - [Install the bridge](https://crow.sg/apps/ai-agent-remote/docs/install/): macOS and Linux kits, running it as a service, updating. - [Pair a phone](https://crow.sg/apps/ai-agent-remote/docs/pairing/): Nearby code or QR invitation, read or control. - [Using the app](https://crow.sg/apps/ai-agent-remote/docs/using-the-app/): Attention, projects, terminals, keys, history, voice and changes. - [Web console](https://crow.sg/apps/ai-agent-remote/docs/console/): Agents, devices, pairing and settings in your browser. - [Web remote](https://crow.sg/apps/ai-agent-remote/docs/web-remote/): The app in a browser, on this computer or your network. - [Reach it from anywhere](https://crow.sg/apps/ai-agent-remote/docs/remote-access/): Your VPN, the reverse relay and the home network. - [Backends & agents](https://crow.sg/apps/ai-agent-remote/docs/backends/): Herdr, Orca or plain terminals, and the agents recognised. - [Security](https://crow.sg/apps/ai-agent-remote/docs/security/): What protects a connection, and how it compares with SSH. - [CLI reference](https://crow.sg/apps/ai-agent-remote/docs/cli/): Every agent-remote command and flag. - [Troubleshooting](https://crow.sg/apps/ai-agent-remote/docs/troubleshooting/): Fixes for the common problems, and answers to questions.