Drive your local pi coding agent from your phone — anywhere on the LAN.
A native Android & iOS app (Compose Multiplatform) that talks to a featherweight Node.js bridge on your PC. Browse every session, watch the agent work in real time, and steer it — all from the couch.
Connect once → browse everything → chat live. Your agent, in your pocket.
| 📂 Projects & Sessions | Every session on your PC, grouped by working directory — open any one and read its full history instantly |
| ⚡ Zero-cost browsing | History is read straight from disk (JSONL). Switching sessions is instant — no agent is spawned just to look |
| 💬 Live chat | Streaming responses, thinking blocks, tool calls with live output, and per-round token usage |
| ⏹️ Interrupt & queue | Stop a running agent with one tap — or send a follow-up that queues politely behind it (steer / followUp) |
| 🆕 Per-session model | Each session picks its own model & thinking level independently, switchable mid-flight |
| 🗜️ Compact on demand | Summarize a bloated context from the + menu and see how many tokens it freed |
| 📊 Session spend | Messages, tokens and dollars for the whole session — one tap from the + menu |
| 🌳 Session tree | Every branch of the session, not just the one you are reading — jump to any earlier point and continue from there (pi's /tree), with a user message handed back to the composer for editing |
| 🖼️ Image attachments | Attach screenshots or photos to a prompt, preview the strip, and zoom into full-size results |
| 🌿 Git at a glance | Uncommitted changes and commit history with per-file / per-commit diffs, rendered as adaptive tables |
| 🔔 Background agent | Leave the app while the agent grinds — a completion notification taps you straight back into the session |
| 👥 Multi-device live sync | Several phones can watch the same session; new messages appear on every screen in real time |
| 🌙 Dark Material 3 | A polished dark-first UI, single-column on phones |
Recommended — no clone, no build, run straight from npm (requires Node ≥ 22.19):
npx pi-remote-bridge # listens on 0.0.0.0:30150
npx pi-remote-bridge --debug # log every HTTP request / WebSocket message (troubleshooting)From source (for development or a local fork):
cd server
npm install
npm startFirst launch prints the connection info and auto-generates a token, along with a QR code to pair the phone in one scan:
pi-remote-bridge 0.4.0
URL: http://192.168.31.117:30150
Token: 85Ou5U44v-lN0BckrE6QJ5OuMgBAekZQ
Listening on all interfaces — only use this on a trusted network.
...
The token lives at ~/.pi/remote/token (mode 600) and survives restarts.
cd app
./gradlew installDebug # installs on a connected deviceOr download from github releases.
Pi Remote ships for iOS 15+ (arm64 devices). There is no prebuilt binary / App Store build yet — you build it yourself with Xcode on a Mac, then load it onto your own phone.
MIT