MIT · pi coding agent

Put pi's workbench in your browser.

pi-star puts pi's sessions, agents, files, Git, terminals and model settings into a local web workbench. The UI comes from pi-web, the server is rebuilt in Rust + Axum, and your data stays in ~/.pi/agent.

Read the docs Download View source

MIT · No private edition · Optional QuadHub Token

pi-star · 127.0.0.1:30151local

Sessions

Add health check
working · quick
Fix build failure
idle · rpc
Review PR #42
waiting · quick

pi · QuickPI~/.pi/agent

Add a health check to the Axum router.

I'll add an /api/health handler and a test.

router.rs · +18 −2

$ cargo test -p pi-star

Rust binary

agent backends

extra servers to deploy

WHY LOCAL

Keep the data on your machine

The data is still pi’s

Keeps reading and writing sessions, models and credentials under ~/.pi/agent; stop pi-star and continue with the pi CLI or pi-web.

Embedded UI, no Node server

Release builds put the pi-web UI inside the Rust binary and serve it through Axum.

QuadHub is optional

Run it entirely on its own, or connect to QuadHub Tokens when you want unified model quotas.

CAPABILITIES

One workbench, six jobs

Local web workbench

Sessions, file tree, chat, model selection, terminal and settings in one interface.

Shares data with pi

Keeps reading JSONL sessions and settings under ~/.pi/agent; stop pi-star and continue with the pi CLI or pi-web.

Two agent backends

Standard PI runs through Node's pi --mode rpc; QuickPI runs in-process, switchable per session.

One Rust binary

Release builds embed the UI and serve it through Axum; the server needs no Node runtime.

Desktop app

A Tauri 2 shell handles launch, supervision, tray and login items; installers bundle Node and pi.

MIT, no private edition

Build it from source; optionally connect model calls to QuadHub Tokens for quota.

ARCHITECTURE

UI, agent and data — all local

The browser talks to pi-star on the machine; the agent runs behind it and data stays in pi’s directory.

Browser

Web UI

pi-web interface · Vite build

Rust binary

pi-star

Axum · agent loop · tools

Files are the source

~/.pi/agent

JSONL · models · auth

QUICK START

Run it from source

cd ui && npm install && npm run build
cd ..
cargo build --release
./target/release/pi-star --port 30151

Open http://127.0.0.1:30151, or install the Linux / macOS / Windows desktop build from Releases.

QUADHUB

optional

Optional QuadHub Token service

pi-star runs on its own, or can send model requests through QuadHub's Token service for unified metering and quotas. Without QuadHub, keep using your own providers and keys.

Read the integration note

MANUAL