Pi GPUI
用 Rust 与 GPUI 打造的 pi 编码代理原生桌面客户端,启动快、内存占用低。
- Star 数
- ★ 184
- 最近更新
- 3 天前
- License
- MIT
- 主语言
- Rust
- FA 评分
- 56/100 · 缺口较多
30 秒速览
- 可在哪里用
- 兼容但需适配
- 开始前需要
- 典型场景
- 日常在终端使用 pi 的开发者,想要一个更快、不占内存的图形前端,同时保留原有的模型、扩展与会话。
- 主要局限
- 仅支持 macOS 13+(Apple 芯片)和 Linux,Windows 明确不支持。
- 官网
- pi-gpui.dev ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-18最新版本 v0.2.8(2026-11-17)
- 源码审查
- 56/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Pi GPUI 是 pi 编码代理的原生图形界面,用 Rust 和 Zed 背后的 GPUI 框架编写,不使用 Electron 或 webview。它并不重新实现代理逻辑,而是通过 RPC 驱动你本机已有的 pi,复用同一套模型、扩展、技能和会话,因此终端里能用的能力在 GUI 里同样可用。界面上有项目与会话侧栏、Zed 风格的面板停靠、会话树、内联扩展提问、上下文环与会话压缩显示,并支持用插件在工具调用中绘制实时视图。应用体积约 16 MB,窗口约 0.4 秒出现,空闲内存约 75 MB(M1 Pro 实测),明显轻于 Electron 客户端。支持 macOS 13+(Apple 芯片)和 Linux(x86_64/arm64,beta),Windows 不支持,以 MIT 协议开源。
应用启动时在 PI_EXECUTABLE、PATH 或登录 shell 中定位 pi(要求 pi 1.4 及以上、限 1.x),为每个打开的会话启动独立的 pi 进程并通过 RPC 通信,切换会话不会中断正在运行的任务。侧栏列出项目及其 pi 会话;右侧浮动面板展示按 git 状态着色的文件与改动,标签页可拖到另一侧、边缘可拖动调整大小。消息框支持粘贴或拖入文件与图片,粘贴图片保存为 $TMPDIR/pi-clipboard-*.png 并以路径形式发送,与终端行为一致。它支持斜杠命令(/compact、/tree、/fork、/clone、/model、/new、/name、/session、/copy、/export 等)、带键盘导航和分支摘要的会话树、从任意消息分叉,以及在转录中内联回答扩展的 select/confirm/input/editor 提问。为实现 pi RPC 缺失的会话树导航,应用会把自带的 extensions/pi-gpui-bridge.ts 传给它启动的 pi 进程,无需额外安装。它还通过 pi install npm:pi-gpui 提供的 /gpui 命令或 pi-gpui://open?workspace=…&session=… 链接接管终端中已开启的会话,并提供插件机制让任意语言编写的插件添加按钮、快捷键、状态、工具与工具调用内的实时视图。
- 日常在终端使用 pi 的开发者,想要一个更快、不占内存的图形前端,同时保留原有的模型、扩展与会话。
- 同时在多个项目中并行运行编码代理的人,希望通过侧栏让每个会话保留自己的 pi 进程,来回切换而不打断工作。
- 习惯 Zed 工作流、想要类似面板停靠、主题与快捷键体验的用户。
- 需要从对话历史任意节点分叉试验不同改法的团队。
- 想为 pi 添加自定义工具或在工具调用中嵌入可视化界面(如示例中的 DOOM 插件)的插件作者。
- 从终端开始会话、之后想转到图形界面继续的人,可用 /gpui 命令或 pi-gpui:// 深链迁移。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
brew install --cask bytesbay/tap/pi-gpuicurl -fsSL https://pi-gpui.dev/install.sh | sh
- 配置文件
~/.local/pi-gpui.app~/.local/bin/pi-gpuiSupport/pi-gpui/settings.json~/.config/pi-gpui/settings.json- 安装说明涉及
- macOS · Linux
如何安装或部署这个 Agent?
macOS(Apple 芯片,macOS 13 或更新)用 Homebrew 安装:
brew install --cask bytesbay/tap/pi-gpui或从 Releases 下载 Pi-GPUI-*.zip 并拖入 Applications;发布包已用 Developer ID 签名并通过 Apple 公证。
Linux(x86_64 与 arm64,beta)执行安装脚本:
curl -fsSL https://pi-gpui.dev/install.sh | sh脚本会把应用放到 ~/.local/pi-gpui.app,链接 ~/.local/bin/pi-gpui 并添加启动器条目,无需 root;也可自行解包 pi-gpui-*-linux-*.tar.gz。Linux 需要 glibc 2.35 及以上(Ubuntu 22.04、Debian 12、Fedora 36)与 Vulkan 驱动,支持 X11 与 Wayland。两种系统都需已安装 pi 1.4 或更高版本(限 1.x),应用会从 PI_EXECUTABLE、PATH 或登录 shell 中找到它。
若要在终端中把当前会话交给应用,安装 pi 扩展:
pi install npm:pi-gpui从源码构建:
cargo run [-- /path/to/project]
script/bundle.sh # macOS: target/release/Pi GPUI.app
script/bundle-linux.sh # Linux: target/release/pi-gpui.app 与发布压缩包如何使用这个 Agent?
首次启动后应用会自动找到 pi;用 ⌘O 添加项目,⌘N 新建会话,⌘1…⌘9 在已打开的会话标签间切换,⌘⇧T 打开会话树,⌘⇧M 调整模型与思考等级,⌘⇧C 压缩上下文,⌘B / ⌘R 收起左右面板。在输入框输入 / 打开命令菜单,↩ 发送、⇧↩ 换行,运行中发送可对 pi 进行干预,Esc 停止。Linux 上 ⌘ 换成 Ctrl、⌥ 换成 Alt,压缩为 Ctrl+Alt+C。也可从命令行直接打开项目:
open "pi-gpui://open?workspace=/path/to/project&session=/path/to/session.jsonl"
pi-gpui /path/to/project设置文件为 ~/Library/Application Support/pi-gpui/settings.json(Linux 为 ~/.config/pi-gpui/settings.json),保存即生效:
{
"theme": "system",
"ui_font_family": ".SystemUIFont",
"agent_font_size": 14,
"buffer_font_family": "JetBrains Mono NL",
"buffer_font_size": 12,
}自定义主题是 settings.json 旁 themes 目录中的 JSON 文件,最少六个颜色即可,也可直接放入 Zed 主题文件。
这个 Agent 有哪些优点和局限?
- 基于 GPUI 的原生实现,不用 Electron 或 webview:约 16 MB 体积、约 0.4 秒出窗口、空闲内存约 75 MB,README 给出了与 Electron 客户端的实测对比方法与脚本。
- 不重造代理:通过 RPC 复用用户已安装的 pi,模型、扩展、技能和会话都与终端一致;每个会话有独立 pi 进程,切换不中断任务。
- 会话树需要 pi RPC 之外的能力,应用以自带 extensions/pi-gpui-bridge.ts 的方式实现,不向用户环境额外安装组件。
- 插件机制允许任意语言添加按钮、快捷键、工具,甚至像示例 DOOM 插件那样在工具调用中绘制实时视图。
- 可从任意消息分叉、内联回答扩展提问,并通过 /gpui 或 pi-gpui:// 深链接接管终端会话;发布包含签名公证与自更新。
- 仅支持 macOS 13+(Apple 芯片)和 Linux,Windows 明确不支持。
- Linux 版仍为 beta:仅在 Ubuntu 24.04 arm64 虚拟机(GNOME X11 与 Weston 下的 Wayland)测试过,其他桌面、真实 GPU 和 x86_64 未验证。
- 强依赖本机已安装的 pi 1.4–1.x,pi 版本兼容区间需要跟随应用发布;新于测试版本的 pi 次版本会被标为“未测试”。
- 存在已记录的限制:同会话在终端中运行的 pi 无法被检测,扩展的 setStatus、setWidget、setTitle 状态行、组件与窗口标题尚未显示。
- 从源码构建需要 Rust 1.90(固定版本)及 macOS 的 Xcode 或 Linux 开发库;非安装到 pi-gpui.app 的构建不会自更新。
这个 Agent 与同类方案有什么区别?
README 将 Pi GPUI 与面向 pi 的 Electron 客户端对比:在 M1 Pro 上不开项目时,Electron 客户端启动需 0.5 到 1.1 秒、占用 190 到 430 MB 内存,而 Pi GPUI 约 0.4 秒、约 75 MB。它也与终端里的 pi 互补——可通过 /gpui 命令把会话从终端迁到图形界面,但不会检测同一会话中仍在终端运行的 pi。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Pi GPUI 当前 | 56 · 缺口较多 | — | ★ 184 | 3 天前 | Rust | — |
| Waku 编程智能体桌面端 | 50 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 1.6k | 1 个月前 | Rust | Codex · Claude Code |
| Hermes Agent CN Desktop | 55 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 1.9k | 1 天前 | TypeScript | — |
| DeepTide - 为 DeepSeek 打造的 AI 编程代理 | 55 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.1k | 3 个月前 | Rust | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
least_privilege:Linux 安装脚本以 curl|sh 方式执行远程脚本,且 /gpui 插件用 /bin/sh 轮询进程后 exec 打开链接,权限面偏宽,仅得 1。user_confirmation:更新与 pi 升级均需点击确认,删除会话走回收站,得 2。data_flow_transparency:README 说明会话/设置存放位置,但未系统说明数据外发路径,得 1。sensitive_data_handling:粘贴图片写入 $TMPDIR、会话文件交接,未见清理或加密说明,得 1。dependency_security:Cargo 依赖版本较新但无审计/锁定说明,得 1。external_effects:外部副作用(更新、pi 升级、打开链接)有明确触发点,得 2。rollback:会话删除进回收站、更新可重启,但无版本回退机制,得 2。source_attribution:README 引用 pi、GPUI、字体等来源,得 2。
self_consistency:README、Cargo.toml、CI 与源码描述基本一致,得 2。dependency_availability:依赖版本存在但未提供锁定/可用性验证,得 1。failure_messages:源码含多处 eprintln 与用户提示,得 2。
audience_and_scenarios:面向 pi 用户的桌面 GUI,场景清晰,得 2。capability_boundaries:Known limits 与 Linux 差异说明清楚,得 2。trigger_precision:/gpui 命令与 pi-gpui:// 链接触发条件明确,但依赖版本探测较脆弱,得 1。environment_fit:macOS/Linux 适配说明详尽,得 2。
information_architecture:README 结构良好,得 2。install_notes:安装说明详尽含签名与依赖,得 3。naming_stability:有旧名迁移逻辑,但命名历史略杂,得 2。examples_and_faq:有示例插件与演示,FAQ 有限,得 2。known_limitations:有 Known limits 与 Linux 说明,得 2。license:MIT 明确,得 3。versioning_changelog:有版本号与 Conventional Commits 约定,但无独立 CHANGELOG,得 2。maintenance_responsibility:发布者未验证,维护责任归属不明,得 1。
output_usability:GUI 输出可用性描述充分,得 2。marginal_value:相对 Electron 客户端有性能优势,得 2。cost_benefit:性能数据来自作者自测,未独立验证,得 1。
claim_traceability:性能数据附方法与脚本链接,得 2。cross_source_corroboration:仅单一来源,无第三方佐证,得 1。fact_inference_separation:README 区分实测与脚本化演示,得 2。
- Linux 安装使用 curl|sh 执行远程脚本,建议先审阅 site/install.sh 再运行。
- /gpui 插件通过 /bin/sh 轮询进程后 exec 打开链接,注意其进程与权限行为。
- 性能数据为作者自测,未经独立复现,勿据此推断可靠性。
- 发布者身份未经验证,维护责任与更新路径需自行核实。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
常见问题
是否需要付费或提供 API 密钥?
它会不会替代或改动我现有的 pi 安装和配置?
Linux 上能正常使用吗?
终端里已经打开的会话能转到 GUI 吗?
有哪些已知缺口?
Pi GPUI 官网是什么?
Pi GPUI 开源吗?
Pi GPUI 安全吗?
Pi GPUI 还在维护吗?
Pi GPUI 是谁开发的?
谢谢反馈,我们会据此改进页面。