pi-forge
v1.3.0
Published
Browser UI for the pi coding agent — embedded HTTP server with a React workbench (chat, file browser, terminal, git, MCP).
Downloads
1,627
Maintainers
Readme
pi-forge
Browser UI for the pi coding agent — an embedded HTTP server with a React workbench (chat, file browser, terminal, git integration, MCP support).
Install
# One-shot
npx pi-forge
# Or install globally
npm i -g pi-forge
pi-forgeOpen http://localhost:3000 and pick a workspace folder.
Configuration
Every knob is settable as a --flag on the pi-forge command OR as
an environment variable. Flags win when both are set. Run
pi-forge --help for the full grouped list.
pi-forge --port 4000 --workspace-path ~/Code
pi-forge --api-key @/run/secrets/api-key --no-expose-docsThe most common knobs:
| Flag | Env var | Default | Purpose |
|---|---|---|---|
| --port | PORT | 3000 | HTTP listen port |
| --workspace-path | WORKSPACE_PATH | ~/.pi-forge/workspace | Where project code lives |
| --pi-config-dir | PI_CONFIG_DIR | ~/.pi/agent | Pi SDK config (auth, models, settings) |
| --forge-data-dir | FORGE_DATA_DIR | ~/.pi-forge | pi-forge state (project list) |
| --ui-password | UI_PASSWORD | (unset) | Enables browser login if set |
| --api-key | API_KEY | (unset) | Enables Authorization: Bearer for programmatic use |
--ui-password, --api-key, and --jwt-secret accept @<path> to
read the value from a file (avoids shell history leakage). If both
--ui-password and --api-key are unset, auth is disabled — for
production, set at minimum --api-key.
Programmatic API
REST + Server-Sent Events under /api/v1/. Interactive docs at
/api/docs. See the project README
for the full surface and example curl flows.
Versioning
This package version (1.3.0) tracks the GitHub release
of the same name. Docker images and the npm package are published in
lockstep on each v* tag.
License
MIT — see LICENSE.
