percho

percho 是一款为 Pi 编程 Agent打造的轻量级桌面图形界面，基于 Electron + React + Tailwind 4，将 Pi CLI 的核心引擎嵌入 Electron 主进程，在简洁美观的可视化界面中提供完整的 Agent 交互体验。

核心能力

percho 并非对 Pi 的重新实现，而是对官方 Pi SDK（@earendil-works/pi-coding-agent）的合法桌面包装，继承 Pi 原生所有优势：TypeScript 扩展、Skill 与提示模板、项目级本地配置、多模型提供商（Claude Pro/Max、ChatGPT Plus/Pro Codex、Anthropic/OpenAI/Gemini/DeepSeek/Bedrock API key）等。

相比纯终端界面，percho 提供更直观的操作方式：多会话侧边栏管理、每条工具调用的可视化审批（基于规则的审批引擎）、follow-up 队列与 undo、Markdown 流式渲染、图片预览、消息复制。Agent 可通过内置 show_image 工具主动展示图片，而不会把每个工具结果都变成噪音。界面支持自定义背景图 + 叠加透明度调节，提供 light / dark / system 三种主题。

技术细节

支持 macOS（Apple Silicon + Intel）和 Windows 两种平台，Node.js ≥ 22.19。安装包发布在 GitHub Releases 页，macOS 首次打开需通过「系统设置 → 隐私与安全性 → 仍然打开」手动授权（Gatekeeper 未公证签名）。配置文件存放在 ~/.pi/agent/ 目录，API key 引用环境变量，不在应用内明文存储，与 Pi CLI 配置完全兼容。

适用人群

已在终端使用 Pi CLI、偏好 GUI 操作的开发者；希望在同一界面中同时管理多个 Agent 会话的团队；需要可视化工具审批流程以便审核 Agent 操作范围的技术负责人。