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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/xpropelpi-remote.svg)](https://yunodb.com/tools/xpropelpi-remote?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/xpropelpi-remote?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/xpropelpi-remote.svg" alt="Featured on YunoDB" height="20"></a>