pi-gui/ui

Pi Status UI

Reason for existence

Provide the desktop control surface for Pi Status Bridge. The UI presents bridge state and forwards user intent; it never owns Pi sessions, worktree routing, or approval policy.

Requirements

• Node.js 20+.
• Rust stable and the native dependencies required by Tauri v2.
• A running Pi Status Bridge socket. By default the app uses $XDG_RUNTIME_DIR/pi-status-bridge/bridge.sock; set PI_STATUS_BRIDGE_SOCKET to override it.

Develop

From the repository root:

npm --prefix ui ci
node src/bridge/cli.js --worktree "$HOME"
npm --prefix ui run tauri dev

The second command starts the bridge; run it in a separate terminal. The Tauri app connects to it on startup.

Commands

npm --prefix ui run dev       # Vite frontend only
npm --prefix ui run build     # typecheck and build frontend assets
npm --prefix ui run tauri dev # run the desktop client
npm --prefix ui run tauri build # package a desktop bundle

Boundaries

• The UI sends operations only to the selected bridge agent.
• Extension responses are forwarded unchanged to Pi.
• The UI must not add a network transport or persist competing model/thinking defaults.

Verification

cargo test --manifest-path ui/src-tauri/Cargo.toml
npm --prefix ui run build

See the root README for bridge setup and repository-wide verification.