快速开始

环境要求

• Rust stable（1.85+）
• Node.js 22+（构建 UI、桌面打包和准备内置 pi 运行时需要）
• 已安装或准备使用 pi coding agent

从源码启动

cd ui
npm install
npm run build
cd ..

cargo build --release
./target/release/pi-star --port 30151

打开 http://127.0.0.1:30151。

release 构建把 ui/dist 内嵌进二进制，因此可以复制到没有 ui/dist 的目录运行。debug 构建默认从仓库的 ui/dist 读取前端资源，修改 UI 后重新执行 npm run build 即可，不必重编 Rust。

桌面应用

从 Releases 下载 Linux、macOS 或 Windows 安装包。桌面安装包自带 Node、pi 和 agent extension，安装后不需要单独准备这些运行时。

桌面壳负责启动、健康检查、崩溃后退避重启、托盘、开机自启和退出时的进程树清理；主窗口只是本地服务的 Web 界面。

开发模式

# 终端 1：Rust 服务（30151）
cargo run -p pi-star

# 终端 2：Vite（30152，/api 代理到 30151）
cd ui && npm run dev

数据位置

pi-star 不创建新的会话格式，默认使用 pi 的数据目录：

• 会话：~/.pi/agent/sessions/<encoded-cwd>/*.jsonl
• 设置：~/.pi/agent/settings.json、models.json、auth.json
• 侧边栏状态：~/.pi/agent/pi-web-session-state.json

可以用 --agent-dir 或 PI_CODING_AGENT_DIR 指向其他数据目录。