Install pi
Run in your terminal
npm install -g @earendil-works/pi-coding-agentpi is the supported harness today.
Getting started
From install to your first agent session.
Prepare pi locally, then run pi-web in the folder where work should happen.
1 · Install pi · Node.js 24+
npm install -g @earendil-works/pi-coding-agent
A new session in the real responsive pi-web interface.
Local setup
Prepare pi. Then start pi-web.
Open pi and sign in
pi
/loginComplete provider login inside pi, then exit it. Authentication belongs to the harness, not pi-web.
Start pi-web in your workspace
Run in your terminal
npx -y @ashwin-pc/pi-web@latestRun it from the folder where work should happen, or set PI_WEB_CWD=/path/to/workspace.
Open the workspace
http://127.0.0.1:8787pi-web uses the local harness you already installed and authenticated.
There is no hosted account or relay in this setup. As additional harnesses arrive, the boundary stays the same: install and sign in to the harness locally first, then let pi-web work through it.
Optional remote access
Bring your own secure path.
Optional bearer token
PI_WEB_TOKEN="$(openssl rand -hex 32)" npx -y @ashwin-pc/pi-web@latestUse Tailscale or an HTTPS reverse proxy you control. A bearer token protects app requests; it does not replace transport security.
Ready?