pi-star
参考
pi-star 的命令行参数、环境变量与数据路径。
命令行
pi-star [--port <port>] [--hostname <host>] [--open]
[--ui-dir <path>] [--agent-dir <path>] [--exit-on-stdin-eof]| 参数 | 说明 |
|---|---|
--port |
监听端口，默认 30151 |
--hostname |
监听地址，默认 127.0.0.1 |
--open |
启动后打开浏览器 |
--ui-dir |
显式从磁盘读取 UI 目录（跳过内嵌资源） |
--agent-dir |
pi 数据目录，默认 ~/.pi/agent |
--exit-on-stdin-eof |
父进程 stdin 关闭时退出，供桌面壳监督 |
环境变量
| 变量 | 说明 |
|---|---|
PORT |
默认端口 |
PI_WEB_HOSTNAME |
默认监听地址 |
PI_STAR_OPEN_BROWSER |
启动时打开浏览器 |
PI_STAR_UI_DIR |
覆盖 UI 目录 |
PI_CODING_AGENT_DIR |
覆盖 pi 数据目录 |
PI_WEB_PASSWORD |
本地登录密码 |
PI_WEB_ALLOWED_HOSTS |
允许的 Host |
PI_STAR_PI_CLI |
指定 pi 可执行文件 |
PI_STAR_AGENT_EXTENSION |
指定 agent extension |
PI_STAR_PI_RPC_MAX_SESSIONS |
同时存活的 pi RPC 会话上限（默认 8） |
数据路径
- 会话：
~/.pi/agent/sessions/<encoded-cwd>/*.jsonl - 设置：
~/.pi/agent/settings.json、models.json、auth.json - 侧边栏状态：
~/.pi/agent/pi-web-session-state.json - 项目资源：
<cwd>/.pi/mcp.json、.pi/skills、~/.pi/agent/skills
端口与进程
默认端口为 30151。桌面壳会持久化端口并保持 origin 稳定；端口冲突时显示错误，不会静默换端口。服务启动后不会自动打开浏览器，除非传入 --open。