@watercol/pi-web-ui

Web-based TUI for the pi coding agent

Packages

Package details

extension

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

npm report

$ pi install npm:@watercol/pi-web-ui

Package: @watercol/pi-web-ui
Version: 0.5.3
Published: Jul 20, 2026
Downloads: 1,680/mo · 388/wk
Author: watercol
License: MIT
Types: extension
Size: 551.4 KB
Dependencies: 0 dependencies · 0 peers

Security note

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

README

Pi Web UI

A web-based terminal UI for the pi coding agent. Connect to a running pi session through your browser.

Light mode

Pi Web UI light mode

Dark mode

Pi Web UI dark mode

The UI supports both light and dark themes. Toggle between them using the button on the right side of the status bar; your choice is persisted and defaults to your system preference.

Prerequisites

Node.js >= 20
pi — the pi coding agent must be installed separately:
```
npm install -g @earendil-works/pi-coding-agent
```

Install

Via pi (recommended)

pi install npm:@watercol/pi-web-ui

安装后 pi-web-ui 命令会自动链接到 pi 的 bin 目录，在 pi 的 bash 工具中可直接使用。如果终端中提示命令不存在，请重新打开终端或将 ~/.pi/agent/bin 加入 PATH。

Via npm

npm install -g @watercol/pi-web-ui

Usage

pi-web-ui

Then open http://127.0.0.1:3210 in your browser.

Options

pi-web-ui [options]

Options:
  --host <host>       Host to bind, default 127.0.0.1
  --port <port>       Port to bind, default 3210
  --cwd <dir>         Working directory for pi --mode rpc, default .
  --pi-bin <path>     Pi executable, default PATH lookup for pi
  --provider <name>   Provider passed to pi
  --model <id>        Model passed to pi

Examples

# Run on a different port, accessible from LAN
pi-web-ui --host 0.0.0.0 --port 8080

# Point to a custom pi binary
pi-web-ui --pi-bin /usr/local/bin/pi-dev

# Specify model and working directory
pi-web-ui --provider openai --model gpt-4o --cwd ~/my-project

Development

cd pi-web-ui
npm install

# Build and run
npm run build
node dist/server/index.js

# Dev mode (auto-rebuild web on change requires separate Vite setup)
npm run dev

# Type-check without emitting
npm run typecheck

# Run tests
npm test

📋 View full changelog

License

MIT