Run Pi sessions, projects, extensions, and developer tools in a fast browser UI that stays local, inspectable, and scriptable.
| Capability | What it means in practice | |
|---|---|---|
| ⚡ | Real-time Pi sessions | Prompt streaming, tool events, abort, retry, compaction, model and thinking controls. |
| 🧭 | Projects and session history | Browse JSONL projects, search full text, fork or clone sessions, navigate branches, and export/import JSONL or HTML. |
| 🧩 | Native WebUI Extensions | Render dialogs, editors, widgets and overlays in the browser while preserving Pi's original TUI fallback. |
| 🔌 | MCP and runtime controls | Configure stdio or Streamable HTTP servers, inspect connection status, and reload idle runtimes safely. |
| 🛠️ | Developer visibility | Read-only files, Git branch/commit/worktree state, environment details and runtime diagnostics in one place. |
| 📦 | Local-first delivery | A standalone CLI, installable PWA, atomic settings, optional notifications and no hosted account required. |
Requires Node.js 22.19+ or Node.js 24+. Node.js 23 is not supported.
npm install --global pi-web-codex
pi-web-codexThe host opens http://127.0.0.1:1816 when the server is ready. Use pi-web-codex --help to see all CLI options.
npx pnpm@11.12.0 install
npx pnpm@11.12.0 devOpen http://127.0.0.1:1816, then run the focused checks below before publishing:
npx pnpm@11.12.0 test
npx pnpm@11.12.0 typecheck
npx pnpm@11.12.0 lint
npx pnpm@11.12.0 buildFor the complete packed-release check:
npx pnpm@11.12.0 release:verifyThis builds the portable standalone tree, verifies the NPM tarball contains both compiled workers and no TypeScript business source, installs it into a temporary global prefix, and starts the installed CLI through its health check.
WebUI Extensions are optional adapters for existing Pi Extensions. They can progressively replace known commands and renderers with browser-native Shadow DOM views. If an adapter is absent, disabled, incompatible, conflicting or fails at runtime, the original Pi behavior and Virtual TUI remain available.
The current milestone covers the production host lifecycle, health and settings APIs, real Pi JSONL projects and standalone tasks, isolated Pi SDK workers, session lifecycle operations, extension settings, MCP management, project Git/file inspection, PWA caching and runtime diagnostics. No UI is presented without a backing operation.