@kkkiio/pi-web-ui

Web UI for Pi coding agent — view and control your Pi session from the browser

Packages

Package details

extension

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

$ pi install npm:@kkkiio/pi-web-ui
Package
@kkkiio/pi-web-ui
Version
0.2.0
Published
Nov 15, 2026
Downloads
701/mo · 375/wk
Author
kkkiio
License
MIT
Types
extension
Size
25.3 MB
Dependencies
4 dependencies · 1 peer
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/kkkiio/pi-web-ui/main/docs/images/pi-web-ui-example.png",
  "extensions": [
    "./extensions/mirror-server.ts"
  ]
}

Security note

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

README

Pi Web UI

Pi Web UI showing a follow-up quoted from an export plan

An interactive agent UI for the Pi coding agent.

Install

Install from GitHub:

pi install git:github.com/kkkiio/pi-web-ui

Or from npm:

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

Usage

  1. Start Pi in terminal
  2. Enter /webui to start the server and open the browser.

Use /webui-stop to stop the server.

See docs/configuration.md for environment variables, settings.json, and remote access setup.

Features

  • Real-time bidirectional sync with Pi TUI
  • Git Diff Panel
  • Edit Message (inline rollback & resend; enabled by /webui)
  • Add to Chat
  • Git Diff Comment
  • BTW / Ask in Side Chat
  • AskUserQuestion
  • Generative UI

Git Diff

Review what the agent changed on disk without leaving the conversation.

Git Diff panel showing the agent's dry-run edit next to the chat

AskUserQuestion

The agent stops to clarify intent before writing code, with a preview of each option.

AskUserQuestion card asking how dry-run should report existing files

How it works

Pi Web UI is a Pi extension. Running /webui starts an HTTP + WebSocket server inside the Pi process. The extension forwards Pi events to the browser, and browser commands execute through Pi's extension API.

graph LR
    A[Pi TUI<br/>terminal] <-->|Pi events| B[Pi Process<br/>pi-web-ui extension]
    B <-->|HTTP + WS :3001| C[Browser]