Pi-Remote
Pi 編碼代理的遠端控制。Pi-Remote 將即時 Pi 終端機工作階段鏡像到任何瀏覽器,讓您能觀看執行、回應提示,並從手機傳送指令
Pi-Remote 是什麼?
Pi 編碼代理的遠端控制。Pi-Remote 將即時 Pi 終端機工作階段鏡像到任何瀏覽器,讓您能觀看執行、回應提示,並從手機傳送指令 — 透過自託管中繼進行端到端加密。
Pi-Remote 概覽
這是什麼
Pi-Remote 是 pi(Earendil 的終端編碼代理)的輔助工具。它透過 pi 的官方擴充 API 附加到正在執行的 pi 工作階段。它不會修改 pi 的原始碼,也不會接管終端機。Pi-Remote 將即時的 pi 終端工作階段鏡像到任何瀏覽器,讓您可以觀看執行過程、回答提示並從手機傳送指令——全程透過自託管中繼進行端到端加密。本機端可在 Windows、macOS 和 Linux 上執行,且可同時連接多台機器。
主要功能
- 即時鏡像 — 終端機的輸出、工具呼叫和狀態變更會即時同步到瀏覽器,重新連線後會增量補齊。
- 遠端輸入 — 從瀏覽器傳送訊息給工作階段。當 pi 忙碌時,訊息可以排隊或引導,並確認送達。
- 遠端指令 — 切換模型和思考層級、手動壓縮、建立/分岔/複製工作階段、瀏覽工作階段樹以及檢視使用量。指令在本機 pi 程序中執行。
- 多裝置 — 多台機器可以共用一個中繼。UI 會列出每台裝置、其線上狀態及其工作階段,並可在選定裝置上啟動新工作階段。
- QR 碼裝置連結 — 在執行 pi 的機器上執行
attach --link;終端機和本機視窗會顯示 QR 碼和配對碼。用手機掃描,在確認頁面上驗證裝置資訊和 2 位數檢查碼,並使用管理員權杖核准——裝置權杖會自動寫入本機的.env檔案。 - 無伺服器模式 — 無需雲端伺服器:中繼在您自己的電腦上執行(一次性
setup --local),手機透過相同 Wi-Fi 的區域網路連線,離家時可依需求開啟 Cloudflare Tunnel 並透過 QR 碼取得臨時公開 URL(URL 每次啟動都會變更,關閉附加視窗即停止所有服務)。 - 桌面與行動 UI — 桌面和行動裝置各有獨立版面,提供六種外觀:Cursor、Claude 和 Codex 的深色與淺色主題。
使用情境
- 從手機或另一台電腦遠端觀看 pi 終端工作階段。
- 在遠離主要機器時回答提示並傳送指令給 pi。
- 從單一瀏覽器介面管理跨多台裝置的多個 pi 工作階段。
- 在無雲端基礎設施的無伺服器本機設定中執行 pi。
- 使用 QR 碼連結快速配對裝置。
快速開始
先決條件: 先在要控制的裝置上安裝 pi: bash npm install -g @earendil-works/pi-coding-agent 需求:Node ≥ 22.18。 以下指令在一台機器上執行完整迴圈,無需伺服器: macOS / Linux: bash npm install npm run relay node deploy/setup.cjs ws://127.0.0.1:7001 deploy/sync-extension.sh # 將擴充安裝到 ~/.pi/agent/extensions/ deploy/attach.sh # 開啟附加視窗;裝置上線 deploy/start-pi.sh # 在第二個終端機中啟動 pi 開啟 http://127.0.0.1:7002 並輸入 .env 檔案中的檢視者權杖。 Windows 的相關指令請參閱儲存庫中的 deploy/start-pi.cmd 指令碼。
授權與價格
MIT 授權,開放原始碼。
內容整理自該專案公開的 README 與儲存庫資訊。