pi-web-ui

Just open your browser to get all your work done — browser cockpit for AI coding agents (chat, code, files, terminal, Git in one tab)

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-web-ui
Package
pi-web-ui
Version
0.119.0
Published
Nov 8, 2026
Downloads
17.7K/mo · 4,084/wk
Author
xingshuyin
License
MIT
Types
extension
Size
14.9 MB
Dependencies
12 dependencies · 2 peers
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/xing-shuyin/pi-web-ui/main/assets/chat-prompts.jpeg",
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

English · 简体中文 · 繁體中文 · Website · Docs · Downloads

The pi-web-ui workspace in action

Watch the walkthrough · MP4

Your project, within reach

Keep your flow Make room for more
Conversations that stay organized. Run parallel conversations, revisit history, and bring files and images into the discussion. A choice of engines. Work with pi, DSH, Claude Code, and Codex, with capabilities specific to each engine.
Tools beside the conversation. Browse and edit files, preview changes, open a terminal, and inspect Git status and diffs. Collaboration you can follow. Connect work on a canvas, coordinate Bot groups, and reach connected devices.
A workspace that feels like yours. Choose themes and languages, with layouts for desktop and mobile. Room to extend. Add Skills, MCP servers, plugins, and UI extensions as your workflow grows.

Start in two commands

Requires Node.js 22.19.0 or later. Run these commands from your project directory.

npm install -g pi-web-ui@latest
pwu .

pwu, piwebui, and pi-web-ui are equivalent commands; all subcommands and options work with each. Use pwu [directory] to start in a project directory.

Open http://127.0.0.1:8787 if the browser does not open automatically. In workspace settings, configure a model provider and its credentials, select a model, and send your first task.

Prefer a packaged app? Choose an Electron desktop build or Windows portable package.

Installation guide · Workspace documentation

More than one way to work

Use chat for a focused task, parallel conversations for separate threads, and subagents for delegated work. Plan mode, goal mode, and review delegation provide different ways to organize execution. Tool approvals let you review tool actions as part of that workflow.

The workspace supports pi, DSH, Claude Code, and Codex through their respective integrations. Session formats, configuration, tools, and available controls vary by engine.

In a pi-hosted workspace, native CLI conversations can also run local pi, Claude Code, Codex, or a configured DSH terminal profile. These are interactive terminal sessions that use each CLI's own installation, login, and permissions; they do not inherit every chat feature.

Execution modes · Native CLI details

Give the work a canvas

Connect task steps, follow runs, and inspect logs and artifacts in a visual workflow. Canvas collaboration brings handoffs and review into view, so the shape of a larger task stays readable.

The canvas workspace in action

Canvas supports execution tracking, approval branches, and reviewable artifacts. Where Git isolation is enabled and supported, changes remain available for inspection and explicit adoption.

Canvas architecture and behavior

Connect people, agents, and machines

Use the device center to work with connected machines and their supported remote desktop and file capabilities. Bot groups bring device-backed agents into a shared conversation for coordination and task dispatch.

Extend the workspace with Skills, MCP, and plugins: add tools, reusable instructions, or your own interface contributions. Browse the community plugin directory, or start with the plugin SDK.

Device center · Bot groups and collaboration · MCP and browser tools

Pick your place to work

Entry point A good fit for
Web Opening the workspace in a browser, locally or through a configured service.
Electron desktop A desktop application with a built-in browser and local workflow integration.
Windows portable A packaged Windows entry point; check the release notes for included components.
Background service / Docker Keeping the workspace available on your own machine or server.

Model credentials are configured separately from the app installation. For remote access, use the deployment guide to configure authentication and your network entry point.

Background service · Docker installation · Deployment guide · CLI and environment

Build with us

To run from source:

git clone https://github.com/xing-shuyin/pi-web-ui.git
cd pi-web-ui
npm ci
npm run dev

The default development frontend is http://localhost:5173. See the development guide for checks, builds, and contribution conventions, or explore the documentation index.

Community

Thanks to pi and its contributors for the upstream coding-agent foundation.

Licensed under MIT.