@gang-of-beads/pi-web

Web UI for persistent Pi Coding Agent sessions in real workspaces.

Packages

Package details

extension

Install @gang-of-beads/pi-web from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@gang-of-beads/pi-web

Package: @gang-of-beads/pi-web
Version: 2.202610.11
Published: Oct 14, 2026
Downloads: 5,981/mo · 844/wk
Author: hanxiaodu
License: MIT
Types: extension
Size: 13.7 MB
Dependencies: 28 dependencies · 4 peers

Pi manifest JSON

{
  "image": "https://raw.githubusercontent.com/Gang-of-Beads/pi-web/main/docs/assets/pi-web-banner.png",
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

PI WEB

PI WEB is a web UI for Pi Coding Agent that keeps agent sessions running in real workspaces on your machine or server.

Run agents where your code, tools, credentials and build caches live. Supervise them from any browser.

PI WEB desktop screenshot

On a phone	Going somewhere else

Why PI WEB?

Agentic development works better when the work environment is persistent. PI WEB lets you:

keep Pi Coding Agent sessions alive after browser disconnects;
run agents inside real repositories and git worktrees;
supervise several sessions in parallel;
switch between laptop, phone, tablet and desktop;
use a server, workstation or remote dev box as your agent runtime;
manage projects, workspaces, files, terminals, sessions and other machines from one web UI.

Your browser is the control surface. The work stays where it can keep running. See Remote-first development.

Quick start

Requirements:

Node.js 22.19.0 or newer, and npm
Pi Coding Agent 1.1.0 or newer, configured for your user
git and the development tools your agents need
Linux or macOS with a per-user service manager (systemd or launchd)

Install and start PI WEB as per-user services:

npm install -g @gang-of-beads/pi-web --allow-scripts=node-pty
pi-web install
pi-web doctor

Then open http://127.0.0.1:8504. To use it from your phone or another device, publish it on your tailnet with Tailscale Serve: see Remote access.

Nix, Home Manager, Docker, installing through Pi, WSL and manual runs: see the installation guide.

Everyday commands:

pi-web status
pi-web logs
pi-web restart
pi-web doctor
pi-web version
pi-web uninstall

Core model

Machine     a PI WEB runtime: the one you opened, or another one you added
Project     a folder on that machine
Workspace   a working folder of the project: the project folder, or with Git, each worktree
Session     a Pi Coding Agent chat running inside a workspace

A typical flow: add a project, choose a workspace or git worktree, start a session, let the agent work, and come back later from any browser.

Security

PI WEB has no login of its own and assumes trusted users, repositories and server paths; it is not a sandbox or a multi-user platform. Keep it on localhost, a private network, an SSH tunnel or an authenticated reverse proxy, never directly on the public internet. See SECURITY.md for the threat model and how to report a vulnerability.

Documentation

Install: requirements, install options, services, updates, remote access
Configuration: config files, keys, environment variables, restart rules
Machines: use several PI WEB machines from one page
Remote-first development
Plugins: PI WEB plugins and Pi packages
FAQ and troubleshooting

Plugins and packages maintained alongside PI WEB: docs/plugins.md.

Contributing

See CONTRIBUTING.md for the development setup, checks and pull request expectations.