$ cat ~/map/pi-gui.md

pi-gui

社区维护的 Electron 桌面 GUI，提供线程化时间线、git worktree 隔离、内建终端与内联 diff 查看器。

tools✓ 10月16日

事实速查

## 速览

pi 的 Codex 风格 Electron 桌面应用：线程化会话时间线、每线程独立 git worktree、多 agent 编排、内建 PTY 终端与内联 diff 查看器——是 pi 运行时之上的 UI 外壳，不是独立的 agent。

$每个会话渲染为 Codex 风格的消息与可折叠工具调用时间线；线程可直接在 workspace（Local）或隔离的 git worktree 中启动，并行工作互不干扰。
$编排线程可以派生并监督子工作线程，做多 agent 协作。
$内建真实 PTY 终端（node-pty）、Cmd/Ctrl+D 切换的内联 diff 面板、@ 引用文件、图片粘贴与拖放进输入框。
$专用视图管理 pi 技能与扩展；明暗主题；agent 运行结束发系统通知；provider 在设置里走 OAuth 或 API key 接入。
$macOS（Apple Silicon）与 Linux（AppImage）公测；macOS 发布包已签名并公证。

Q 怎么安装？

从 GitHub Releases 下载 .dmg 或 .AppImage；macOS 也可 brew tap minghinmatthewlam/tap && brew install --cask pi-gui（brew upgrade --cask pi-gui 升级）。

Q 需要单独配置模型吗？

不需要。pi-gui 构建在 @earendil-works/pi-coding-agent 之上，复用 pi 的认证与会话状态——CLI 里已有的配置全部沿用，新 provider 在 Settings → Providers 里接入。