agegr/pi-web

Web UI for the pi coding agent

Pi Web – a browser UI for the Pi coding‑agent

What it is – Pi Web is a local web‑based interface that lets you work with the Pi coding agent (a command‑line AI‑assistant for code). It reads the same configuration and session files that the Pi CLI uses, so you can browse, resume, and branch conversations, manage model credentials, and inspect project files – all from a browser window.

Key capabilities

  • Session workspace – list sessions by project, see usage stats (tokens, cost, compaction), rename, export or delete them, and create new branches from any message.
  • File explorer – browse the files a session knows about, upload new ones, view Git diffs, and preview many formats (Markdown, source code, images, audio, PDFs, DOCX) with live refresh.
  • Git worktree support – switch between different worktree checkouts while keeping sessions grouped per repository.
  • Configuration panel – add or edit model providers, API keys, plugins and skills without leaving the UI.
  • Multilingual UI – English, Simplified and Traditional Chinese, auto‑selected from the browser language.

How to run it

  1. Install Node 22.19+.
  2. Start with the one‑liner npx @agegr/pi-web@latest (or install globally with npm i -g @agegr/pi-web).
  3. A local server starts on 127.0.0.1:30141 and opens your default browser.
  4. If you haven’t configured a model provider yet, open the Models panel and add your API key.

Configuration & security

  • Port, hostname, idle timeout, and password protection are controllable via CLI flags or environment variables (PI_WEB_PASSWORD, PI_WEB_IDLE_TIMEOUT_MS, etc.).
  • By default it binds only to localhost; exposing it on a network requires a strong password and a reverse‑proxy for TLS.
  • The UI only accesses files inside the working directories known to the Pi agent, not the whole filesystem.

Development – The repo is a Next.js + React app written in TypeScript. Run npm install && npm run dev for a hot‑reloading dev server. Tests, type‑checking, and linting are provided.

Who it’s for – Anyone who uses the Pi coding agent and wants a richer, visual way to manage sessions, files, and model settings without leaving the command line.

License – MIT.

Related

  • Project
    jmfederico/pi-web

    A web UI for the Pi Coding Agent that enables persistent, remote-first AI coding sessions running in real workspaces on your machine or server.

  • Project
    justhil/pi-app

    pi Desktop is a cross‑platform Electron app that provides a graphical UI for the existing *pi* coding‑agent. It shares the same `~/.pi/agent` files as the CLI, showing sessions in a timeline, offering Git‑style diffs, file browsing, parallel workers, extension adapters, themes, and optional voice input.

  • Project
    Gentleman-Programming/gentle-shell

    gentle-shell is a terminal‑based coding‑agent workspace built on the Pi AI platform. It lets a parent session launch focused sub‑agents, shows live diffs, usage stats, and a command palette, and follows an “Organic Driven Development” workflow. Install via `npm i -g gentle-pi` and run `gentle-shell` (or `--link` to reuse an existing Pi setup).

  • Project
    MichaelKinsy/PiG

    PiG is a Go‑native reimplementation of the Pi terminal coding‑assistant, offering a fast single‑binary AI pair‑programmer compatible with Pi’s extensions and configurable via “Piglets.”

  • Project
    BlackBeltTechnology/pi-agent-dashboard

    PI Dashboard is a web/Electron UI that lets you run, monitor, and interact with multiple *pi* AI coding‑agent sessions in real time, with features like workspace organization, token‑cost tracking, integrated terminal, OpenSpec/flow support, provider management, and extensibility via plugins.