Maintainer of this skill?
by Xpropel
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.
# Add to your Claude Code skills
git clone https://github.com/Xpropel/Pi-RemoteSee how Pi-Remote compares with popular alternatives.
Pi-Remote is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Xpropel. 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. It has 129 GitHub stars.
Pi-Remote's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/Xpropel/Pi-Remote" and add it to your Claude Code skills directory (see the Installation section above).
Pi-Remote is primarily written in TypeScript. It is open-source under Xpropel on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Pi-Remote against similar tools.
No comments yet. Be the first to share your thoughts!
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
Pi-Remote 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. The session stays in the local pi process at all times; the browser shows a real-time mirror of that session and can send messages and commands back to it, including switching models, changing the thinking level, compacting context, and navigating the session tree. The local side runs on Windows, macOS, and Linux, and several machines can be connected at the same time.
Relationship to pi: Pi-Remote is a companion tool built for pi, Earendil's terminal coding agent, on pi's official extension API, for people who use pi. It is not a fork, variant, or replacement of pi: pi itself keeps running in the local terminal, and Pi-Remote only adds a remote mirror and control surface for it.
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. The manual pairing-code flow remains available.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).| Component | Location | Role |
|---|---|---|
| Sync extension | extension/pi-remote-sync.ts |
Runs inside the pi process. Forwards session events, receives remote messages and commands and executes them locally, reconnects after drops |
| Relay | relay/ |
Node service running on a server. Handles authentication, forwarding, and the device/session index. Holds no model credentials and no local files |
| Web UI | ui/ |
Served by the relay. Renders the session stream, sends messages and commands, manages devices and sessions |
The full protocol definition is in readyUI/data-interface.md.
Prerequisite: install pi on your device first. Pi-Remote is a companion tool for pi and does not include pi itself. Before using Pi-Remote, install pi on the machine you want to control and make sure it runs:
npm install -g @earendil-works/pi-coding-agent
Requirements: Node ≥ 22.18.
The following runs the full loop on one machine, no server involved:
Windows:
npm install
npm run relay # 127.0.0.1:7001 (extension channel) and 7002 (web UI)
deploy\start-pi.cmd # in a second terminal: start pi
macOS / Linux:
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 running the relay on a server (systemd setup, token management, troubleshooting), see deploy/README.md.
npm install
npm --prefix ui install
npm test # unit and protocol tests; needs neither pi nor a model
cd ui && npx tsc -b && npm run build
Make sure tests pass before submitting, and that the change contains no .env files, tokens, private keys, or real session content.
| Role | Contributor |
|---|---|
| Founder | Xpropel |
| UI design | Muse (Meta) |
| Code implementation | DeepSeek |
| Project planning | Claude, ChatGPT |