minghinmatthewlam/pi-gui

解决的问题

pi-gui 为 pi 编码代理提供原生桌面界面，无需再仅通过命令行界面与代理交互。它将代理交互组织成一个可视化、可管理的环境，并集成了开发工具。

工作原理

它作为基于 Electron 的 UI 框架，封装了 @earendil-works/pi-coding-agent 运行时。不重新实现代理逻辑，而是以 pi 自身的 JSONL 会话文件作为会话历史的唯一真实来源，并依赖上游 pi 包进行模型认证、会话管理和执行。

适用人群

使用 pi 编码代理并希望获得图形化界面，具备可视化差异对比、集成终端和有序会话时间线等功能的开发者。

主要亮点

• 线程化时间线：将代理会话可视化为类似 Codex 的消息时间线，并支持折叠的工具调用。
• Git 工作树：支持在本地工作区或隔离的 Git 工作树中启动线程，防止并行工作冲突。
• 多代理编排：支持编排线程，可创建并监督子工作线程。
• 集成工具：内置 PTY 终端和内联差异查看器，用于审查文件变更。
• Composer 功能：支持在提示中 @ 引用文件，以及拖拽上传图片附件。
• 会话管理：支持归档旧线程，并通过专用视图管理 pi 技能和扩展。