Pi-Remote
Remote control for your pi coding agent. Pi-Remote mirrors live pi terminal sessions to any browser, so you can watch runs, answer prompts, and send commands fr
What is Pi-Remote?
Remote control for your pi coding agent. Pi-Remote mirrors live pi terminal sessions to any browser, so you can watch runs, answer prompts, and send commands from your phone — end-to-end encrypted over a self-hosted relay.
Overview of Pi-Remote
What it is
Pi-Remote is a companion tool for pi, Earendil's terminal coding agent. It attaches to a running pi session through pi's official extension API. It does not modify pi's source code and does not take over the terminal. Pi-Remote mirrors live pi terminal sessions to any browser, so you can watch runs, answer prompts, and send commands from your phone — end-to-end encrypted over a self-hosted relay. The local side runs on Windows, macOS, and Linux, and several machines can be connected at the same time.
Key features
- Live mirroring — output, tool calls, and status changes in the terminal sync to the browser in real time, with incremental catch-up after a reconnect.
- Remote input — send messages to the session from the browser. While pi is busy, messages can queue or steer, and delivery is confirmed.
- Remote commands — switch model and thinking level, compact manually, create / fork / clone sessions, navigate the session tree, and inspect usage. Commands execute in the local pi process.
- Multiple devices — several machines can share one relay. The UI lists each device, its online state, and its sessions, and can start a new session on a chosen device.
- QR device linking — run
attach --linkon the machine that runs pi; the terminal and a local window show a QR code and a pairing code. Scan it with a phone, verify the device info and the 2-digit check code on the confirmation page, and approve with the admin token — the device token is then written to the local.envautomatically. - Serverless mode — no cloud server required: the relay runs on your own computer (one-time
setup --local), your phone connects over the LAN on the same Wi-Fi, and when you leave home you can turn on a Cloudflare Tunnel on demand and open a temporary public URL by QR code (the URL changes on every start, and closing the attach window stops everything). - Desktop and mobile UI — separate layouts for desktop and mobile, with six skins: Cursor, Claude, and Codex looks in dark and light.
Use cases
- Watching pi terminal sessions remotely from a phone or another computer.
- Answering prompts and sending commands to pi while away from the main machine.
- Managing multiple pi sessions across different devices from a single browser interface.
- Running pi in a serverless local setup without cloud infrastructure.
- Using QR code linking for quick device pairing.
Getting started
Prerequisite: Install pi on the device you want to control first: bash npm install -g @earendil-works/pi-coding-agent Requirements: Node ≥ 22.18. The following runs the full loop on one machine, no server involved: macOS / Linux: bash npm install npm run relay node deploy/setup.cjs ws://127.0.0.1:7001 deploy/sync-extension.sh # install the extension into ~/.pi/agent/extensions/ deploy/attach.sh # open the attach window; the device comes online deploy/start-pi.sh # in a second terminal: start pi Open http://127.0.0.1:7002 and enter the viewer token from your .env. For Windows, see the deploy/start-pi.cmd script in the repository.
License and pricing
MIT license, open source.
Based on the project's public README and repository metadata.