Skip to content

p1rallels/pi-mobile

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pi-mobile

Web UI for the pi coding agent, built on the @mariozechner/pi-coding-agent SDK.

pi-mobile runs the agent on whatever machine hosts the server. You connect from any device (laptop, phone, tablet) to control and view sessions through a browser.

  • Create, resume, and stream sessions live (reasoning, tool calls, output)
  • Stream assistant output, reasoning, and tool execution live
  • Switch model and thinking level mid-session
  • Mobile-friendly: keybar for Esc / Release / Take over / Enter, slide-out sidebar
  • Tailscale — bind to your tailnet IP, auto-TLS with MagicDNS, no token needed
  • Cloudflare Tunnels — expose securely with cloudflared, Cloudflare Access for auth
  • Face ID / Touch ID — WebAuthn enrollment for biometric access control on remote

SDK upstream: https://github.com/badlogic/pi-mono

piwebdemo.mp4

Sessions are JSONL on disk, same location as the native pi CLI.

Quick start

bun install
bun run dev -- --port 4317

Open http://localhost:4317.

Note: Face ID (WebAuthn) generally requires a hostname like localhost or a real domain; raw IPs like 127.0.0.1 may fail.

See the Runbook (RUNBOOK.md) for Tailscale, Cloudflare, and token auth setup.

Data locations

What Path
Sessions (JSONL) ~/.pi/agent/sessions/
Saved repos ~/.pi/agent/pi-web/repos.json
Face ID credentials ~/.pi/agent/pi-web/faceid-credentials.json

Session semantics

  • Abort stops the current run but keeps the session runtime alive. Never deletes JSONL.
  • Release aborts and disposes the web runtime so you can safely resume the same JSONL in the native CLI (no concurrent writers).

Do not open the same session in pi-web and the native pi CLI simultaneously. Use Release in the web UI before resuming in the CLI.

Credits

Built on top of pi by badlogic.

About

pi, your machine, all on the go on your phone. start, monitor, resume pi sessions securely, wherever you have a browser

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors