pi-star
Reference
pi-star CLI flags, environment variables and data paths.
CLI
pi-star [--port <port>] [--hostname <host>] [--open]
[--ui-dir <path>] [--agent-dir <path>] [--exit-on-stdin-eof]| Flag | Description |
|---|---|
--port |
Listen port, default 30151 |
--hostname |
Listen address, default 127.0.0.1 |
--open |
Open the browser after start |
--ui-dir |
Read the UI from disk instead of embedded assets |
--agent-dir |
pi data directory, default ~/.pi/agent |
--exit-on-stdin-eof |
Exit when the parent’s stdin closes (desktop supervision) |
Environment
| Variable | Description |
|---|---|
PORT |
Default port |
PI_WEB_HOSTNAME |
Default listen address |
PI_STAR_OPEN_BROWSER |
Open the browser on start |
PI_STAR_UI_DIR |
Override the UI directory |
PI_CODING_AGENT_DIR |
Override the pi data directory |
PI_WEB_PASSWORD |
Local login password |
PI_WEB_ALLOWED_HOSTS |
Allowed hosts |
PI_STAR_PI_CLI |
Path to the pi executable |
PI_STAR_AGENT_EXTENSION |
Path to the agent extension |
PI_STAR_PI_RPC_MAX_SESSIONS |
Max live pi RPC sessions (default 8) |
Data paths
- Sessions:
~/.pi/agent/sessions/<encoded-cwd>/*.jsonl - Settings:
~/.pi/agent/settings.json,models.json,auth.json - Sidebar state:
~/.pi/agent/pi-web-session-state.json - Project resources:
<cwd>/.pi/mcp.json,.pi/skills,~/.pi/agent/skills
Port and process
The default port is 30151. The desktop shell persists the port and keeps the origin stable; a port conflict is reported rather than silently changed. The service does not open a browser unless --open is passed.