@youweichen/pi-web-ui

Web chat interface for the pi coding agent, powered by the pi SDK (@earendil-works/pi-coding-agent) — one-command run, Docker/systemd/launchd deployable

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@youweichen/pi-web-ui
Package
@youweichen/pi-web-ui
Version
0.46.0
Published
Sep 1, 2026
Downloads
237/mo · 237/wk
Author
youweichen
License
MIT
Types
extension
Size
6.2 MB
Dependencies
16 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

pi-web-ui

Web chat interface for the pi coding agent SDK — chat in the browser, browse the file tree, attach files, built-in terminal (xterm.js + node-pty), model management, sound notifications, Chinese/English UI.

Fork of xing-shuyin/pi-web-ui with personal fixes (e.g. Kimi-style </antThinking> leaked-reasoning tags).

Requirements

  • Node.js >= 22.19.0
  • A configured pi agent (~/.pi/agent, e.g. via pi CLI) with at least one model provider

Install & run

npm i -g @youweichen/pi-web-ui
pi-web-ui                 # http://127.0.0.1:8787
pi-web-ui --port 9000 --cwd /path/to/project

or without installing:

npx @youweichen/pi-web-ui

Upgrade

npm i -g @youweichen/pi-web-ui@latest
pi-web-ui server restart   # if you installed the autostart service

Autostart on boot

pi-web-ui server install    # macOS → launchd, Linux → systemd, Windows → Task Scheduler
pi-web-ui server status     # start | stop | restart | uninstall also available

Notes

  • Binds to loopback (127.0.0.1) by default; set PI_WEB_HOST to expose on LAN.
  • Optional shared-password auth: PI_WEB_TOKEN=secret pi-web-ui.
  • node-pty is a native module — on Windows you may need Visual Studio Build Tools if no prebuilt binary matches.

中文简介

pi 编码智能体的 Web 聊天界面：浏览器对话、文件树、附件、内置终端、模型管理、声音提醒、中英文切换。全局安装后一条命令启动，支持开机自启（launchd / systemd / Windows 计划任务）。

License

MIT