@rotriz/pi-web-ui
v1.6.0
Published
Web UI extension for the Pi coding agent — browser-based session management, git integration, and task tracking
Maintainers
Readme
pi-web-ui
A browser-based Web UI for the Pi coding agent. Provides a full-featured interface for managing sessions, workspaces, git operations, and monitoring agent task progress.
Features
- Multi-session management — Browse, switch, and delete sessions grouped by workspace/project
- Parallel tabs — Run multiple independent agent sessions simultaneously
- Git integration — Branch management, selective staging, commit, push/pull, and diff viewing
- Task tracking — Automatically extracts task plans from agent output and shows completion progress
- Workspace switching — Change working directories with automatic session context switching
- Real-time streaming — SSE-based live updates for agent responses, tool calls, and thinking
- Dark/light theme — System-aware with manual override
- Responsive design — Collapsible sidebar, floating panels
Installation
As a Pi extension (recommended)
pi install npm:pi-web-uiOr manually clone into your extensions directory:
git clone https://github.com/your-repo/pi-web-ui ~/.pi/agent/extensions/pi-web-ui
cd ~/.pi/agent/extensions/pi-web-ui && npm installStandalone
git clone https://github.com/your-repo/pi-web-ui
cd pi-web-ui && npm install
node server.mjsOpen http://localhost:3123 in your browser.
Configuration
| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| PORT | 3123 | HTTP server port |
| PI_WEB_PORT | 3123 | Same as PORT (takes precedence) |
| PI_WEB_PI_MODULE | (auto-detected) | Path to @earendil-works/pi-coding-agent/dist/index.js — set this if auto-detection fails |
Troubleshooting
If the extension fails to start with a module resolution error:
# Find where pi-coding-agent is installed
npm root -g
# Or: which pi → look at the symlink target
# Set the env var and restart pi
export PI_WEB_PI_MODULE=$(npm root -g)/@earendil-works/pi-coding-agent/dist/index.js
piRequirements
- Node.js 20+
@earendil-works/pi-coding-agentinstalled (globally or locally)- Git (for git integration features)
Architecture
server.mjs— Node.js HTTP/SSE server that wraps the Pi SDK runtimeindex.html— Single-file frontend (HTML + CSS + JS, no build step)- Dependencies:
marked(markdown rendering),dompurify(HTML sanitization)
License
MIT
