minghinmatthewlam/pi-gui

解決的問題

pi-gui 為 pi 編碼代理提供原生桌面介面，無需再僅透過命令列介面與代理互動。它將代理互動組織成視覺化、可管理的環境，並整合開發工具。

工作原理

它作為基於 Electron 的 UI 外殼，封裝 @earendil-works/pi-coding-agent 執行環境。不重複實作代理邏輯，而是以 pi 自身的 JSONL 會話檔案作為會話歷史的唯一真實來源，並依賴上游 pi 套件進行模型驗證、會話管理與執行。

適用對象

使用 pi 編碼代理並希望獲得圖形化介面，具備視覺化差異對比、整合終端與有序會話時間軸等功能的開發者。

主要亮點

• 線程化時間軸：將代理會話視覺化為類似 Codex 的訊息時間軸，並支援摺疊的工具呼叫。
• Git 工作樹：支援在本地工作區或隔離的 Git 工作樹中啟動線程，防止並行工作衝突。
• 多代理編排：支援編排線程，可建立並監控子工作線程。
• 整合工具：內建 PTY 終端與內嵌差異檢視器，用於審查檔案變更。
• Composer 功能：支援在提示中 @ 引用檔案，以及拖曳上傳圖片附件。
• 會話管理：支援歸檔舊線程，並透過專用視圖管理 pi 技能與擴充功能。