minghinmatthewlam/pi-gui

这是什么？

核心功能

• 01支持并行运行多个代理线程，每个线程可选择独立的 Git 工作树。
• 02审查标签页可查看未提交修改、分支或单轮改动的差异，并按文件暂存。
• 03对话旁边内置终端、文件浏览器和编辑器。
• 04与 pi CLI 共享会话、凭据和技能配置。
• 05提供定时任务、通知和带快捷键的命令面板。
• 06支持通过 OAuth、API Key 或自定义端点接入模型服务商。

适用场景

• 让多个编码代理同时处理不同功能或缺陷修复。
• 在提交前逐文件审查代理所做的修改。
• 在代理对话旁的终端中直接运行测试，无需切换窗口。
• 在应用运行期间定时执行重复性任务，例如每周依赖检查。

快速上手

1. 1

   通过 Homebrew 添加 tap 仓库

   brew tap minghinmatthewlam/tap
2. 2

   信任该 tap（首次安装必需）

   brew trust minghinmatthewlam/tap
3. 3

   安装 pi-gui cask

   brew install --cask pi-gui
4. 4

   打开 pi-gui，在 设置→Providers 中连接模型提供商，然后添加工作区并发送第一个提示

使用前须知

• !原生构建仅支持 macOS（Apple Silicon）、Linux（x64）和 Windows（x64）。
• !Windows 版本尚未进行代码签名，SmartScreen 可能会显示警告。
• !它是 pi 编码代理的桌面外壳，需要配置模型提供商或 API 密钥才能正常工作。

收录于专题

标签

常见问题

pi-gui 是什么？

pi 编程代理的 Electron 桌面应用，支持并行运行代理线程、Git 工作树隔离、差异审查和内置终端。 pi-gui 是 pi 编程代理的桌面外壳。会话、模型、认证和工具都由 pi 本身运行，因此用 pi CLI 配置好的内容可以直接沿用。每个任务对应一个独立线程，可以在当前代码目录中开始，也可以放在新的 Git 工作树里，方便多个代理并行工作。

pi-gui 可以免费使用吗？用的什么许可证？

pi-gui 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

pi-gui 还在维护吗？

活跃维护中。pi-gui 最近一次提交是在 2026年11月2日。

pi-gui 适合用来做什么？

让多个编码代理同时处理不同功能或缺陷修复。 在提交前逐文件审查代理所做的修改。 在代理对话旁的终端中直接运行测试，无需切换窗口。 在应用运行期间定时执行重复性任务，例如每周依赖检查。

pi-gui 怎么安装和运行？

通过 Homebrew 添加 tap 仓库: brew tap minghinmatthewlam/tap 信任该 tap（首次安装必需）: brew trust minghinmatthewlam/tap 安装 pi-gui cask: brew install --cask pi-gui 打开 pi-gui，在 设置→Providers 中连接模型提供商，然后添加工作区并发送第一个提示

在哪里获取 pi-gui？

源代码和安装说明在 GitHub 上：https://github.com/minghinmatthewlam/pi-gui