TannerMidd / pi-pocket

# Pi Pocket
**Your Pi coding agent, in your pocket.**
A durable, multiplayer, mobile-first web app for Pi agents, built on Pi Durable. 
Runs on your own machine or directly on your phone. No cloud VM.
Website · Quick start · Features · Remote access
## Quick start
Requires Node.js 22.19 or newer. Runs on Linux, macOS, Windows, and Android (Termux); Linux is the most tested. Sign in to a provider with Pi first (`pi`, then `/login`), or later from the app's Providers sheet.
 [code] 
The launcher asks how your devices should connect, then prints the address, a sign-in link, and a QR code. Open the link once per browser; the cookie lasts a year. The link is the owner's key, so keep it private. `--rotate-token` replaces it and signs out every device that used the old link; people you invited stay signed in until you remove them under Menu → People.
While it runs: **q** quit · **r** restart server · **a** change access · **o** open in browser · **s** show QR code.
## Features
- **Durable.** Every model call, tool call, and subagent is stored as it happens. Restart the server mid-run and the work continues; a cut-off tool call reruns only if that is safe.
- **Multiplayer.** Share a live session: presence, a side chat Pi does not see, @mentions, pins, reactions, shared notes, and take turns.
- **Steer or queue.** Redirect Pi while it works, queue follow-ups, or stop it.
- **PiP, your assistant.** Alt+A opens "Pi in Pocket" over any screen: it lists, reads, starts, and messages your other sessions, follows their runs, and tells you what came of them. What sessions and GitHub say reaches it as data, never as instructions.
- **Watches and webhooks.** Tell PiP to watch a GitHub repository ("when CI fails on main, fix it and tell me"), or watch a pull request from a session until it merges; webhooks bring other services' posts to Pi. Only the repository's own people count, unless you say anyone.
- **Memory.** Lessons Pi keeps across sessions, per project or everywhere. Pi proposes them; the owner approves what it saw.
- **Dictation.** Speak into the message box, or PiP's, with the browser's own speech recognition.
- **Forks.** Fork from any reply, edit a message and send it again, or retry it with another model. Each fork is a session of its own, optionally in a git worktree of its own.
- **Works while you're away.** Schedule messages to Pi (`/schedule every weekday 8:00 summarize CI`), and `/until npm test` keeps Pi going until the check passes.
- **Plan mode.** Pi reads and proposes a plan; nothing changes until someone approves it.
- **Any provider, any model.** Uses Pi's own model runtime and sign-ins, skills, and prompt templates, with the model and thinking level chosen per session.
- **Themes.** Pocket, the app's own look, and Lantern, a calm, warm dark theme for long reading. Duplicate one and change it with Pi: each save shows at once. The owner picks the default for new browsers.
- **Omarchy colors.** Every Omarchy theme's colors, or follow your des