@jmfederico/pi-web

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

Packages

Package details

extension

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

npm repo home report

$ pi install npm:@jmfederico/pi-web

Package: @jmfederico/pi-web
Version: 1.202610.3
Published: Oct 13, 2026
Downloads: 10.2K/mo · 2,528/wk
Author: jmfederico
License: MIT
Types: extension
Size: 11.8 MB
Dependencies: 27 dependencies · 3 peers

Pi manifest JSON

{
  "image": "https://raw.githubusercontent.com/jmfederico/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 multiple sessions from any browser, even after disconnecting.

PI WEB desktop screenshot

Quick start

Requires Node.js 22.19.0+, npm, Pi Coding Agent 1.x configured for your user, git, and the development tools your agents need.

npm install -g @jmfederico/pi-web --allow-scripts=node-pty
pi-web install
pi-web doctor

On npm 12, the scoped flag lets node-pty prepare its required native module.

Open http://127.0.0.1:8504. Add a project, choose a workspace or Git worktree, and start a session.

pi-web status
pi-web logs
pi-web restart
pi-web update
pi-web uninstall

For installation variants, Docker, and remote access, see the installation guide.

Core model

Machine: a local or remote PI WEB runtime.
Project: a folder on that machine.
Workspace: a working folder, such as a Git worktree.
Session: a Pi Coding Agent conversation running in a workspace.

Use files, terminals, plugins, and agent workflows in one UI. Register remote machines to supervise work across a fleet.

Security

PI WEB assumes trusted users, repositories, paths, and plugins. It is not a sandbox or a multi-tenant platform.

For remote access, use a trusted private network, VPN, SSH tunnel, or authenticated reverse proxy. Do not expose PI WEB directly to the public internet.

Documentation

Development

npm install
npm run dev

Open the Vite URL, usually http://localhost:8505. See development checks for verification guidance.