v0.32 Windows MIT PI CODING AGENT · DESKTOP WORKSPACE

一个窗口， 管好整个 Agent 工作流

Pi GUI 为 Pi Coding Agent 提供本地桌面工作空间： 项目、会话、模型、工具执行与文件变更，尽在掌握。

下载最新版↓ 查看源码→

本地优先 · 多会话 · 可视化工作流 · 受控撤销 · 内置浏览器

WORKSPACE PREVIEW可交互示意 01 / 04
Pi GUI / my-project LOCAL
恢复会话逻辑已连接
你YOU

帮我梳理这个仓库的会话恢复逻辑，并指出需要修改的文件。

πPI AGENT

正在检查会话状态与恢复流程，已定位相关模块。

⌘read_filelib/session-recovery.js完成 ✓

已找到 3 处关键调用，接下来核对恢复路径。

＋给 Pi 发送消息…Claude Sonnet↗
Pi Coding Agent·本地运行
在同一窗口管理多个项目与会话，随时切换工作上下文。纯前端演示，不会执行真实任务。
01 主要功能 7 项

把 Agent 工作流
切分到看得见的每一步

A

项目与会话

按项目整理历史会话，支持搜索、分叉、归档与多会话并行工作。

B

Agent 对话

流式消息、Markdown、Thinking 展示、工具执行时间线与文件附件。

C

Git 变更

右侧工作面板实时查看文件与 Diff，支持审阅与受控撤销。

D

模型管理

切换供应商、模型与思考等级，管理认证与项目备用模型。

E

工作面板

按需打开内置浏览器、文件变更、Specs 与协同工作区。

F

任务与审阅

创建带依赖的任务，组织 Agent 执行，检查结果与验证证据。

G

扩展能力

管理 Skills、Extensions 与 Pi 原生 MCP，按需安装扩展。

02 工作方式 4 步

每一步都可见
可停，可回退

  1. 01

    描述任务

    选定项目文件夹，把要做的事写进输入框。

  2. 02

    Agent 执行

    工具调用逐条展开，命令与读写实时可见。

  3. 03

    审阅变更

    右侧面板看文件与 Diff，确认改到点上。

  4. 04

    受控撤销

    不满意就回退，历史会话随时接回。

03 架构 本机链路

不接管 Pi，
只把它放到窗口里

Pi GUI 是 Electron 桌面应用，界面通过本机端口连接本地服务， 再由服务以官方 RPC 协议驱动独立的 Pi 子进程。全局 Pi 安装不被修改。

  • 01

    独立安装

    依赖你本机已安装的 Pi Coding Agent，版本与配置由你掌控。

  • 02

    回环访问

    界面与服务走本机回环端口，不对公网暴露。

  • 03

    进程治理

    单个 Pi 子进程与桥接，停止、恢复与清理都有明确边界。

LAYER 01

桌面窗口

Electron 渲染进程 · 窗口与工作台

IPC
LAYER 02

本机服务

server.js · 127.0.0.1:7788

stdio · JSONL
LAYER 03

Pi 子进程

pi --mode rpc · 独立安装身份

工具调用
WORKSPACE

工作区

文件 · Git worktree · 内置浏览器 · MCP / Skills

04 控制与安全 可恢复

改得动，也收得住

A

受控撤销

变更按会话记录，回退有边界、有确认，撤销结果可核对。

B

审阅与验证

Diff 逐行确认，任务结果附带验证证据，避免凭感觉收工。

C

会话恢复

退出或中断后接回会话与草稿，后台任务状态不丢。

05 对照 同一套 Pi

终端直接跑，
还是放进窗口

两边驱动的是同一个 Pi，协议也是同一套 RPC。区别只在操作面：命令行轻、可脚本化；窗口把会话、变更与任务摊开。

TERMINAL

命令行里的 Pi

  • 一条命令就能开始，占用最低
  • 天然适合脚本、管道与批量任务
  • SSH 进远程机器照样能用
  • 变更靠自己敲 git diff 核对
PI GUI

窗口里的同一个 Pi

  • 侧栏按项目组织会话，可搜索与分叉
  • 右栏逐文件 Diff，改动可受控撤销
  • 工具调用逐条展开，Thinking 可回看
  • 任务与验证证据留在同一处

短活、脚本、远程调度留在终端；长会话、多项目、要盯 Diff 的活放进窗口。

06 本地优先 数据边界

数据留在你的机器上

Electron + Node.js 通过本机 RPC 连接 Pi，项目与会话保存在本地， 不要求云端账户，不上传使用遥测。使用云端模型时，请求直接发往你所配置的供应商。

Windows 安装程序经 SignPath.io 免费代码签名，证书由 SignPath Foundation 提供；源码以 MIT 协议开放。

  • 0云端账户要求
  • 0使用遥测数据
  • 本地项目与会话存储
  • MIT开源许可证
07 快速开始 约 5 分钟

三步开始工作

1

安装 Pi

Pi GUI 使用本机独立安装的 Pi Coding Agent，需要 Node.js 22.19+ 并配置模型供应商。

npm install -g @earendil-works/pi-coding-agent
pi --version
2

下载 Pi GUI

在 Releases 选择 Windows 版本： 安装版 Pi-GUI-Setup.exe 或便携版 Pi-GUI-portable.zip。

3

开始工作

打开 Pi GUI，添加本地项目文件夹，在输入框描述任务，右侧面板检查文件变更与执行结果。

08 下载 最新版本

现在就把它装上

正在读取 GitHub 最新发布…

安装版

Pi-GUI-Setup.exe

下载文件 →

便携版

Pi-GUI-portable.zip

下载文件 →

从源码运行、测试与发布流程见 开发文档。遇到问题请到 Issues 反馈。

09 更新日志 全部版本 ↗

持续打磨，
逐步完善

发布记录将从 GitHub 自动载入。查看 Releases ↗
10 常见问题 4 条

你可能想问

Pi GUI 是免费的吗？+

免费。项目以 MIT 协议开源，安装包不收费；模型调用产生的费用由你所配置的供应商收取。

需要注册账户吗？+

不需要云端账户。项目与会话保存在本地，不依赖 Pi GUI 的服务器。

必须先安装 Pi 吗？+

是。Pi GUI 通过官方 RPC 协议驱动本机独立安装的 Pi Coding Agent，需先安装 Node.js 22.19+ 并配置模型供应商。

支持哪些系统？+

当前发布提供 Windows 安装版与便携版，界面与操作以桌面端为准。