jmfederico/pi-web

Web UI for Pi Coding Agent that keeps sessions alive in real workspaces.

TypeScriptMIT Last commit 14 hours ago pi-web.dev

Open on GitHub

Last 24 hours: +2; stars
Last 7 days: +17; stars
Last 30 days: +113; stars
Total stars: 881; 768 a month ago
Forks: 178; 22 contributors

Star history

Last 12 weeks · weekly cumulative stars · computed from public GitHub star events

Rank in its topics

Position among repos ranked in each topic (min. 20 stars gained)

Rank of jmfederico/pi-web in each topic for today, this week and this month
Topic	Today	This week	This month
TypeScript	–	–	#447of 846
Coding agents	–	–	#395of 531

Health signals

HealthyChecked Oct 14, 2026

Commit activity: Commits in 13 of the last 13 weeks 895 commits on the default branch in 90 days
Maintainers: 2 active maintainers Top author: 99% of the last 100 commits
Issue responsiveness: Median first response: 3 days 26 of the latest 50 issues opened in 90 days are closed
Pull requests: 37 merged, 1 closed, 12 open Of the latest 50 opened in 90 days
Releases: Last release: 3 days ago 32 releases in the last 12 months
Project hygiene: License, CI; no security policy
OpenSSF Scorecard: Not scanned Unknown, not counted against the project

Signals are computed automatically from public GitHub data. They are not an endorsement or a security audit. How health is computed

README

README.md

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.

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.