Pi Web UI

Use Pi from a local browser with tabs, streaming responses, uploads, model controls, Git helpers, and optional companion features.

What you can do

• Work in several Pi sessions at once.
• Change models and thinking effort without leaving the browser.
• Upload files and images, use slash-command suggestions, and manage follow-up prompts.
• Resume sessions, switch projects, and use guided Git helpers.
• Keep phone sessions compact with expandable terminal navigation and secondary composer actions.
• Add optional themes, statistics, remote access, voice features, and other companion packages.

Install

pi install npm:@firstpick/pi-package-webui

Restart Pi after installation.

Start it

Inside Pi, run:

/webui-start

Open the printed address, usually http://127.0.0.1:31415/. Check a running server with /webui-status.

You can also install the standalone launcher:

npm install -g @firstpick/pi-package-webui
pi-webui

If no working directory is supplied, the browser asks which project to open first.

To create a parallel checkout, click the Git branch box in the footer and use Create branch worktree. After the worktree is created, the browser asks whether to open it in a separate Pi tab and switch there; choosing Cancel keeps the current tab active and leaves the new worktree available for later.

On a phone, tap the current terminal name to open full-screen terminal navigation. Grouped terminals use their title as a dropdown; open the group, then choose an individual terminal. The composer keeps the prompt, attachment, Send, and active-run controls visible; tap More to open session, workflow, command, and mode controls in a full-screen overlay, then use the top − control or Escape to minimize it. Todo progress stays on one line until you tap it to expand the full goal, progress bar, and checklist. Git footer Details opens full-screen with refresh inside and a top − button to minimize it; session metrics and workspace, Git, and runtime details use compact grouped grids instead of stretched rows. Phone layouts use balanced compact text, spacing, cards, and 40-pixel controls so more content remains visible. Hover-only tooltips stay hidden on touch controls. In the Control Deck, desktop section dragging and Alt+Arrow movement are always available. On a phone, tap Edit to enable reordering, then tap Done to lock the order again.

Keep it private

Pi Web UI can do anything the connected Pi session is allowed to do. It listens only on 127.0.0.1 by default. Do not expose it directly to an untrusted network. Use the optional Remote Web UI package when you need trusted-LAN access and PIN protection.

Technical details

See TECHNICAL.md for command-line options, settings, update and rollback behavior, session continuity, security, compatibility, and troubleshooting.