Pi Web is a local browser UI for Pi Coding Agent. It reads the same configuration and session files as pi (by default under ~/.pi/agent), so conversations started in the terminal can be browsed and resumed in the browser, agent turns can be run, models and resources configured, and project files inspected. Changes made in the Models panel are visible to both interfaces because they share pi's model, settings, and credential storage.
The server is a Next.js application distributed as an npm package; it requires Node.js 22.19.0 or newer and listens on 127.0.0.1:30141 by default. Because binding to a non-loopback address exposes an agent that can execute high-privilege actions, PIWEBPASSWORD enables HTTP Basic Auth (the username is always pi), PIWEBALLOWEDHOSTS allow-lists reverse-proxy hostnames, and remote access is directed through HTTPS on a trusted reverse proxy or a VPN. Server-side model requests honour HTTPPROXY, HTTPSPROXY, and NOPROXY. The file browser is limited to working directories selected in Pi Web and the project or session roots it already knows.
Features
- Session workspace: browse, resume, rename, export, and delete conversations grouped by project, with running state, context usage, cost, and compaction details
- Branching: New session creates an independent session file from an earlier message; Edit from here creates a branch inside the current session
- Project file tools: browse and upload files, inspect Git diffs, and preview source, Markdown, images, audio, PDFs, and DOCX files with automatic refresh
- Git worktrees: switch checkouts from the sidebar while sessions from the same repository stay grouped
- Web-based configuration: provider login and API keys, models, model tests, plugin packages, and skills
- Localised UI: English, Simplified Chinese, and Traditional Chinese, following the browser language initially with a switcher in the top bar
- Downstream context menu hook: a cancelable pi-web:session-row-contextmenu browser event lets Electron wrappers supply a session-row menu without patching the sidebar
- Startup options: port, hostname, and browser auto-open via flags or environment variables, and PIWEBSKIPVERSIONCHECK=1 disables update checks
