Pi GPUI

用 Rust 与 GPUI 打造的 pi 编码代理原生桌面客户端,启动快、内存占用低。

Star 数
★ 184
最近更新
3 天前
License
MIT
主语言
Rust

30 秒速览

可在哪里用
兼容但需适配
开始前需要
pi 1.4 或更高版本(pi 1.x)macOS 13+(Apple 芯片)或 glibc 2.35+ 且带 Vulkan 驱动的 LinuxRust 1.90(仅从源码构建时需要)Shell / 命令行网络访问本地文件系统
典型场景
日常在终端使用 pi 的开发者,想要一个更快、不占内存的图形前端,同时保留原有的模型、扩展与会话。
主要局限
仅支持 macOS 13+(Apple 芯片)和 Linux,Windows 明确不支持。
官网
pi-gpui.dev ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-18最新版本 v0.2.8(2026-11-17)

这个 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=… 链接接管终端中已开启的会话,并提供插件机制让任意语言编写的插件添加按钮、快捷键、状态、工具与工具调用内的实时视图。

  1. 日常在终端使用 pi 的开发者,想要一个更快、不占内存的图形前端,同时保留原有的模型、扩展与会话。
  2. 同时在多个项目中并行运行编码代理的人,希望通过侧栏让每个会话保留自己的 pi 进程,来回切换而不打断工作。
  3. 习惯 Zed 工作流、想要类似面板停靠、主题与快捷键体验的用户。
  4. 需要从对话历史任意节点分叉试验不同改法的团队。
  5. 想为 pi 添加自定义工具或在工具调用中嵌入可视化界面(如示例中的 DOOM 插件)的插件作者。
  6. 从终端开始会话、之后想转到图形界面继续的人,可用 /gpui 命令或 pi-gpui:// 深链迁移。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • brew install --cask bytesbay/tap/pi-gpui
  • curl -fsSL https://pi-gpui.dev/install.sh | sh
配置文件
~/.local/pi-gpui.app ~/.local/bin/pi-gpui Support/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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
56/ 100 五分制 2.8 / 5
信任安全 14/29
可靠稳定 8/14
适用触发 10/18
规范维护 13/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

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。

可靠稳定8 / 14 · 2.9/5

self_consistency:README、Cargo.toml、CI 与源码描述基本一致,得 2。dependency_availability:依赖版本存在但未提供锁定/可用性验证,得 1。failure_messages:源码含多处 eprintln 与用户提示,得 2。

适用触发10 / 18 · 2.8/5

audience_and_scenarios:面向 pi 用户的桌面 GUI,场景清晰,得 2。capability_boundaries:Known limits 与 Linux 差异说明清楚,得 2。trigger_precision:/gpui 命令与 pi-gpui:// 链接触发条件明确,但依赖版本探测较脆弱,得 1。environment_fit:macOS/Linux 适配说明详尽,得 2。

规范维护13 / 18 · 3.6/5

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。

有效结果7 / 13 · 2.7/5

output_usability:GUI 输出可用性描述充分,得 2。marginal_value:相对 Electron 客户端有性能优势,得 2。cost_benefit:性能数据来自作者自测,未独立验证,得 1。

证据核验4 / 8 · 2.5/5

claim_traceability:性能数据附方法与脚本链接,得 2。cross_source_corroboration:仅单一来源,无第三方佐证,得 1。fact_inference_separation:README 区分实测与脚本化演示,得 2。

风险与缓解建议
  • Linux 安装使用 curl|sh 执行远程脚本,建议先审阅 site/install.sh 再运行。
  • /gpui 插件通过 /bin/sh 轮询进程后 exec 打开链接,注意其进程与权限行为。
  • 性能数据为作者自测,未经独立复现,勿据此推断可靠性。
  • 发布者身份未经验证,维护责任与更新路径需自行核实。
证据充分度:低 评估于 2026年11月20日 审查版本 a8d40e30c4ea
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/pi-gpui.svg?lang=zh)](https://followagents.com/zh/agents/pi-gpui)
<a href="https://followagents.com/zh/agents/pi-gpui"><img src="https://followagents.com/badge/pi-gpui.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.2.8 Pi GPUI 0.2.8
    发布说明摘录
    Full Changelog: https://github.com/bytesbay/pi-gpui/compare/v0.2.7...v0.2.8
    在 GitHub 查看 ↗
  2. v0.2.7 Pi GPUI 0.2.7
    发布说明摘录
    Full Changelog: https://github.com/bytesbay/pi-gpui/compare/v0.2.6...v0.2.7
    在 GitHub 查看 ↗
  3. v0.2.5 Pi GPUI 0.2.5
    发布说明摘录
    Full Changelog: https://github.com/bytesbay/pi-gpui/compare/v0.2.4...v0.2.5
    在 GitHub 查看 ↗

常见问题

是否需要付费或提供 API 密钥?
应用本身以 MIT 协议开源、免费,但它驱动的是你已安装的 pi,因此模型费用与密钥由你的 pi 配置决定,应用不替你管理。
它会不会替代或改动我现有的 pi 安装和配置?
不会重写 pi。应用通过 RPC 使用本机 pi,模型与思考等级按会话设置、不改 pi 默认值;pi 与扩展的更新只有在你点击后才会用 pi 自己的 pi update 执行。
Linux 上能正常使用吗?
当前为 beta:同一套代码,需要 glibc 2.35+、Vulkan 驱动,支持 X11 与 Wayland,但仅在 Ubuntu 24.04 arm64 虚拟机中测试过,作者在 issue #5 收集反馈。
终端里已经打开的会话能转到 GUI 吗?
可以。安装 npm:pi-gpui 后在 pi 中执行 /gpui,它会关闭该 pi 并在 Pi GPUI 中打开同一会话;其他工具可用 pi-gpui://open 链接完成同样操作。
有哪些已知缺口?
同一会话在终端中运行的 pi 不会被检测;扩展的 setStatus、setWidget、setTitle 尚未显示,但 select、confirm、input、editor 类型的扩展提问已支持。
Pi GPUI 官网是什么?
Pi GPUI 的 GitHub 仓库填写的官网是 https://pi-gpui.dev。这个链接由仓库作者设置;源码在 GitHub(bytesbay/pi-gpui)。
Pi GPUI 开源吗?
开源。源码在 GitHub(bytesbay/pi-gpui),许可证是 MIT。
Pi GPUI 安全吗?
FollowAgents 的 FARS 评审(2026年11月20日)给 Pi GPUI 的“信任与安全”打了 14/29 分。评审检查的 8 项安全措施没有完全缺失的。
Pi GPUI 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-18,在最近 30 天内。最新版本是 v0.2.8(2026-11-17)。
Pi GPUI 是谁开发的?
Pi GPUI 由 GitHub 账号 bytesbay 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念