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 --link on 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 .env automatically.
  • 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/xpropelpi-remote.svg)](https://yunodb.com/tools/xpropelpi-remote?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/xpropelpi-remote?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/xpropelpi-remote.svg" alt="Featured on YunoDB" height="20"></a>