$ cat ~/map/pier.md

Pier

pi 的 macOS 桌面客户端：以 pi --mode rpc 驱动会话，流式转录、内联 diff 与扩展对话框。

tools✓ 9月12日

事实速查

安装

下载 Pier 的 DMG 安装包（ad-hoc 签名，应用内自动更新）

## 速览

pi 编码代理的 macOS 桌面 GUI 客户端：每个会话启动一个 pi --mode rpc 进程，流式呈现转录与内联 diff，编辑器支持后续问题升级为转向，扩展对话框以浮层呈现。

$直接使用你已有的 pi 安装：每个打开的会话对应一个 pi --mode rpc 进程，模型、设置、扩展与斜杠命令的行为与终端一致，任意会话都可用 pi -c 回到终端续接。
$从 ~/.pi/agent/sessions 推导出 pi 跑过的全部项目并按项目归组会话，侧栏带有未读与待输入标记，Dock 图标显示角标。
$流式呈现转录：markdown、折叠的思考过程、带实时输出的工具调用与内联编辑 diff；编辑器支持 / 命令、@ 文件提及、粘贴图片与上箭头历史，一轮运行期间可排队后续问题并升级为转向（steering）。
$提供模型与思考级别选择器、上下文用量表、扩展发布的状态文本、当前 git 分支，以及随文件变化刷新的工作区对 HEAD 只读 diff，外加项目目录内的登录 shell。
$要求 Apple silicon 的 macOS 与 PATH 上 pi 0.85 及以上版本；应用自身偏好存于 ~/.pi/gui/settings.json，其余配置仍归 pi 本体。

Q 首次启动为什么出现 Gatekeeper 提示？

DMG 仅做 ad-hoc 签名且未经公证，macOS 会询问一次——在系统设置的隐私与安全性里点「仍要打开」即可；之后的自动更新不再触发提示。

Q Pier 会替换我的 pi 配置吗？

不会——它驱动机器上已有的 pi 安装。应用自身的偏好存于 ~/.pi/gui/settings.json，模型、设置、扩展与斜杠命令照常工作。