by TannerMidd
A durable, multiplayer, mobile-first web app for Pi agents, built on Pi Durable
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery 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.
Automated security scan — not a certification.
# Add to your Claude Code skills
git clone https://github.com/TannerMidd/pi-pocketGuides for using ai agents skills like pi-pocket.
Last scanned: 10/6/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-10-06T11:02:35.305Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how pi-pocket compares with popular alternatives.
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 · Feature tour · Docs
The feature tour covers everything else, from plan mode and peek tiles to the built-in browser.
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.
npm install -g pi-pocket
pi-pocket
Newer npm may print "install-scripts ... not yet covered by allowScripts" for @google/genai and protobufjs, which come from Pi's model library. The warning is expected: Pi Pocket needs neither script. npm config set allow-scripts=@google/genai,protobufjs --location=user quiets it by letting both run, which does no harm.
Or try it with npx pi-pocket. To change Pi Pocket's code, run a git checkout instead:
git clone https://github.com/TannerMidd/pi-pocket.git
cd pi-pocket
npm install
npm start
The launcher asks how your devices should connect, then prints a sign-in link and a QR code. The link is the owner's key: keep it private. --rotate-token replaces it and signs out every device that used it.
While it runs: q quit · r restart server · a change access · o open in browser · s show QR code.
Updating: Menu → Update Pi Pocket updates a git checkout run with npm start, or a global npm install (npm install -g pi-pocket) that your user can write, and restarts. It goes back by itself if the new version does not start (features). A local install (npm install pi-pocket in a project) and npx pi-pocket do not update from the app: the sheet says what to run, npm install pi-pocket@latest or npx pi-pocket@latest. By hand: stop the server, back up ~/.pi-pocket, pull, run npm install, and start again; for a global install, run npm install -g pi-pocket@latest. If the machine stops at the very moment of the switch, pi-pocket may not start; npm install -g pi-pocket restores it. Read the release notes first: 0.21.0 and 0.28.0 upgrade the data one way, so going back needs the backup.
Docker or Podman: docker compose up -d --build. See docs/docker.md.
Nix: nix run github:TannerMidd/pi-pocket, or the NixOS module services.pi-pocket.enable = true; (nix/module.nix).
Android (Termux):
pkg update && pkg upgrade && pkg install nodejs git
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi # /login, then quit
git clone https://github.com/TannerMidd/pi-pocket.git
cd pi-pocket && npm install --ignore-scripts && termux-wake-lock && npm start
Lancet Guard may not load on Android. If it is on but fails, start with PI_POCKET_GUARD=off.
Choose a mode in the launcher, or pass --access:
| Mode | Who can connect | Notes |
|---|---|---|
local |
This machine | 127.0.0.1; bring your own tunnel to port 8787 |
lan |
Your local network | Plain http |
cloudflare |
Anyone with the link | Free https quick tunnel, no account; needs cloudflared |
tailscale |
Your tailnet | Plain http on the tailnet address |
tailscale-serve |
Your tailnet | https at the tailnet name; needs tailscale 1.52 or newer |
tailscale-serve needs the tailscale command on your PATH, signed in, with MagicDNS and HTTPS certificates enabled in the tailnet, and, when the launcher does not run as root, that user as tailscaled's operator (sudo tailscale set --operator=$USER). It serves port 443 at the machine's tailnet name, and a server restart keeps the address. When the launcher quits it takes down the mount it made; one it found already in place is left where it is. Without the command the launcher says so and stops rather than falling back to this device only when nobody is there to pick another mode. --host cannot be combined with it: serve always listens on 127.0.0.1 and lets tailscaled reach it. For another tunnel (ngrok), choose local and point it at port 8787.
Other options: --port (8787), --cwd, --data (~/.pi-pocket), --host, and -y to reuse the last access choice. --host overrides the address a named mode would listen on, and one launcher runs per data folder (a second one says which pid holds it). npm start -- --help lists them all. PI_POCKET_BROWSER and PI_POCKET_BROWSER_ARGS pick the built-in browser and its flags when Chromium or Chrome is not found by itself. PI_POCKET_PROMPT_DATE=1 puts today's date in Pi's system prompt; it is left out by default, so the prompt cache does not start over when the date changes. PI_POCKET_SESSION_CACHE=off keeps browsers from saving the sessions they open on the device (IndexedDB), so that they keep them in each tab's memory only; it is on by default. PI_POCKET_CACHE_KEEPER=off turns off the prompt cache keeper, which keeps a model's prompt cache warm while a run waits on a tool call (features). PI_POCKET_KEEPALIVE_SECONDS (default 5, from 1 to 3600) is how long the server keeps an idle connection open for its next request. Behind a reverse proxy of your own (Caddy, nginx, a load balancer), set it above the proxy's idle timeout, or set the proxy's below it: otherwise the proxy can send a request on a connection as the server closes it, and answers with a 502. Caddy keeps idle connections for 2 minutes by default, so PI_POCKET_KEEPALIVE_SECONDS=125, or keepalive 4s in Caddy's transport http block.
[!WARNING] Anyone who can steer a session can make Pi run commands on this machine, as you. That reaches your files, Pi Pocket's own settings and tokens, and its code. Invite only people you would trust at your keyboard. View-only users cannot make Pi act. SECURITY.md says what is protected and what is not.
npm run check # type-check
npm test # server tests with a scripted model
npm run format # ESLint's layout fixes, then Prettier
npm run lint # check the layout rules
web/ changes reload every open browser, and extensions reload into the running server. node test/serve.ts runs a throwaway copy to check a change on. AGENTS.md covers editing Pi Pocket safely from inside itself, and CONTRIBUTING.md how to send a change.
package.json.The full list has the details.
Inspired by Mario Zechner's demo of his own Pi app. Pi Pocket is an independent project, not affiliated with Earendil. The bundled fonts keep their own licenses, which are beside them in web/fonts/. Dependencies keep their own licenses too; one is not MIT: HEIC photos are decoded with libheif-js (LGPL-3.0), installed as an ordinary npm package that you can replace.
MIT. To report a security problem, s
pi-pocket is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by TannerMidd. A durable, multiplayer, mobile-first web app for Pi agents, built on Pi Durable. It has 863 GitHub stars.
Yes. pi-pocket passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/TannerMidd/pi-pocket" and add it to your Claude Code skills directory (see the Installation section above).
pi-pocket is primarily written in TypeScript. It is open-source under TannerMidd 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-pocket against similar tools.
No comments yet. Be the first to share your thoughts!