@versot/vaguspi

pi-web — a web frontend for the pi coding agent. Launch the full chat UI in your browser with one command.

Packages

Package details

package

Install @versot/vaguspi from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:@versot/vaguspi

Package: @versot/vaguspi
Version: 0.1.10
Published: Sep 8, 2026
Downloads: 1,466/mo · 865/wk
Author: versot
License: MIT
Types: package
Size: 1.2 MB
Dependencies: 7 dependencies · 0 peers

Security note

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

README

@versot/vaguspi

A web frontend for the pi coding agent. Launch the full chat UI in your browser — no pi install required.

Quick start

# Run without installing (recommended)
npx @versot/vaguspi web

# Or global install then run
npm install -g @versot/vaguspi
pi-web web

Opens http://127.0.0.1:19707/ with chat, session history, model config, MCP servers, skills, and usage stats.

Install as a pi package

pi install npm:@versot/vaguspi

Installs the web frontend into your pi package directory (~/.pi/agent/npm/) and lists it on pi.dev/packages. Launch with:

npx pi-web web
# or
~/.pi/agent/npm/@versot/vaguspi/dist/bin.js web

How it works

pi-web embeds the pi SDK in-process and reuses your existing ~/.pi/agent configuration — models, auth, packages, MCP servers, and sessions are shared with the pi CLI. It never writes to your pi config; it just reads it.

Built-in MCP

The web GUI includes MCP server management (设置 → MCP 服务器). Servers configured in ~/.pi/agent/mcp.json connect lazily in web sessions; servers with "enabled": false cost zero context.