pi-webappA workbench for the Pi coding agent

Conversations, project files, terminals and Git side by side, in your browser or a desktop app. Pi keeps running the agent; pi-webapp adds the workspace around it.

npx pi-webapp

Needs Node.js 22.19 or later · run it in a project folder · listens on your machine only

Quick start

What is pi-webapp?

GitHub

The workbench

Discuss → inspect → review → verify

The conversation on the left, your tools on the right. Every step stays in the same workspace.

Review before you commit Read the diff line by line and stage only what you mean to commit.

how it fits together

The agent runs on your machine. Only model requests leave it.

One local service sits between the browser and Pi. There is no pi-webapp cloud.

your machine

Browser or desktop windowThe same workbench

Local service127.0.0.1 · random port · access token

Pi agentTools · sessions · skills

your provider

Model providerThe service you chose

Start in one command

Run npx pi-webapp in a project folder, connect a model, and send your first message.

Quick start

Work across projects

Chats run independently. Switch workspaces or start another chat while earlier work keeps running.

Sessions and workspaces

Files, terminal and Git beside the chat

Preview files, run a real shell and review diffs without leaving the conversation.

Workspace tools

Editable diagrams

Ask for an architecture diagram or flowchart and edit it on a native Excalidraw canvas.

Diagrams

Your models, your data

Bring your own provider. Sessions and credentials stay in Pi's data folder on your machine.

Security and privacy

Something not working?

Symptom, cause and fix for the problems people actually hit.

Troubleshooting

Get started

Pick the way that fits you

All three show the same workbench and share the same Pi data.

Web launchernpx pi-webappThe default choice. A background service that keeps running when you close the terminal or the tab.Quick start →Inside Pi/webAlready in Pi’s terminal interface? Get a browser view of the same session.How it works →Desktop apppi.appIts own window with Node.js and Pi bundled, nothing else to install.Download and install →

127.0.0.1Listens on your machine only

Access tokenChecked on every request

No telemetryError reporting is opt-in

MITOpen source license

The agent and terminal run with your own permissions; this is not a sandbox. Read Security and privacy →