Repolode
Submit
TannerMidd

TannerMidd/pi-pocket

A self-hosted, mobile-first web app for running Pi coding agents from your phone or browser, with sessions that survive server restarts.

View on GitHubWebsite
Stars
782
Forks
83
Open issues
40
Last commit
2 days ago

What is it?

Pi Pocket is a web interface for Pi coding agents, built on Pi Durable. It runs on your own machine or directly on an Android phone through Termux, so no cloud VM is needed. Every model call, tool call, and subagent is stored as it happens, so a run continues after the server restarts.

The app supports multiplayer sessions with live presence, a side chat that Pi does not see, invites, and roles, where view-only users cannot make Pi act. On phones it offers push notifications, dictation, sharing into Pi from other apps, and a home-screen install. Remote access can go through LAN, Cloudflare quick tunnels, or Tailscale, and it works on Linux, macOS, Windows, and Android.

Models and sign-ins come from Pi itself, with the model chosen per session. The app has no build step, and Pi can edit Pi Pocket while it runs. Docker, Podman, and Nix setups are also documented.

Key features

  • 01Durable sessions that continue running after a server restart.
  • 02Shared multiplayer sessions with presence, roles, and invites.
  • 03Phone features including push notifications, dictation, and a home-screen app.
  • 04Remote access via LAN, Cloudflare tunnel, or Tailscale.
  • 05Per-session model selection using Pi's own providers and sign-ins.

Use cases

  • Continuing a coding session with Pi from a phone while away from your desk.
  • Letting a teammate follow or join a live agent session with view-only or steering roles.
  • Running a self-hosted Pi agent on a home machine or spare Android device without a cloud VM.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/TannerMidd/pi-pocket.git
  2. 2

    Enter the project folder

    cd pi-pocket
  3. 3

    Install dependencies

    npm install
  4. 4

    Start the server and follow the launcher prompts

    npm start

Things to know

  • Pi Durable is experimental and its API can change between releases.
  • Only one server process can use the database at a time.
  • Pi's own extensions are not supported.
  • Anyone who can steer a session can make Pi run commands on the host machine.

In collections

Open-source AI agent frameworks & appsAI coding assistants & agentsSelf-hosted appsAndroid apps & phone tools

Topics

#ai-agent#coding-agent#mobile#pwa#self-hosted#multiplayer#typescript#omarchy#pi#pi-durable

FAQ

What is pi-pocket?
A self-hosted, mobile-first web app for running Pi coding agents from your phone or browser, with sessions that survive server restarts. Pi Pocket is a web interface for Pi coding agents, built on Pi Durable. It runs on your own machine or directly on an Android phone through Termux, so no cloud VM is needed. Every model call, tool call, and subagent is stored as it happens, so a run continues after the server restarts.
Is pi-pocket free to use? What license does it have?
pi-pocket is open source under the MIT license. Check the license terms before using it in commercial products.
Is pi-pocket still maintained?
Actively maintained. The last commit to pi-pocket was on Nov 5, 2026.
What can I use pi-pocket for?
Continuing a coding session with Pi from a phone while away from your desk. Letting a teammate follow or join a live agent session with view-only or steering roles. Running a self-hosted Pi agent on a home machine or spare Android device without a cloud VM.
How do I install pi-pocket?
Clone the repository: git clone https://github.com/TannerMidd/pi-pocket.git Enter the project folder: cd pi-pocket Install dependencies: npm install Start the server and follow the launcher prompts: npm start
Where can I get pi-pocket?
The source code and installation instructions are on GitHub: https://github.com/TannerMidd/pi-pocket

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects