pi-web：讓 Pi Coding Agent 留在真實工作區

README 定義的專案入口：pi-web 第 1 節

第 1 節聚焦 pi-web 的 README 線索：PI WEB https://github.com/jmfederico/pi-web/actions/workflows/ci.yml https://www.npmjs.com/package/@jmfederico/pi-web package.json LICENSE PI WEB is a web UI for Pi Coding Agent https://github.com/earendil-works/pi/tree/main/packages/coding-agent that keeps agent sessions running in real workspaces on your machine or server. Run agents where your code, tools, credentials, and build caches live. Supervise them from any browser. Website and docs: https://pi-web.dev/ Why PI WEB? Agentic development works better when the work environment is persistent. PI WEB lets you: - keep Pi Coding Agent sessions alive after browser disconnects; - run agents inside real repositories and git worktrees; - supervise multiple sessions in parallel; - switch between laptop, phone, tablet, and desktop; - use a server, workstation, or remote dev box as your agent runtime; - manage projects, workspaces, files, terminals, sessions, and rem。這段材料說明專案目前公開的用途與操作語境，本文只依照儲存庫材料整理，不把描述延伸成 README 沒有承諾的能力。

對使用者而言，第 1 節的線索要放回完整流程理解。可以從 jmfederico/pi-web 的 README、設定檔與範例名稱開始，確認輸入如何進入 pi-web，中間產生什麼可見結果，以及輸出是否符合自己的工作環境。若材料沒有交代某項行為，應保留為未說明，而不是用相近工具的經驗補上。

評估 pi-web 的第 1 個檢查點是：ote machines from one web UI. Your browser is the control surface. The work stays where it can keep running. Quick start Requirements: - Node.js 22.19.0 or newer - npm - Pi Coding Agent =0.84.0 , configured for your user - git and the development tools your agents need Install and start PI WEB as per-user services: bash npm install -g @jmfederico/pi-web --allow-scripts=node-pty pi-web install pi-web doctor On npm 12, the scoped flag lets node-pty prepare its required native module without enabling install scripts for other dependencies. Then open: text http://127.0.0.1:8504 Useful commands: bash pi-web status pi-web logs pi-web restart pi-web doctor pi-web version pi-web uninstall !-- Keep README guidance concise. Put install variants, troubleshooting, configuration, and operational details in docs/, then link from here. -- For more install options, including one-line install, Pi package install, WSL/manual usage。這比只看 stars 或一句功能摘要更有辨識力，也能把版本差異、權限、資料格式或外部服務依賴及早暴露。實際記錄時，請把輸入、輸出、錯誤訊息和執行環境分開保存，方便回頭對照這個專案自己的行為。每節都應保留專案名稱與具體檔案或指令，這樣後續核對不會只剩抽象印象。

功能如何落到使用流程：pi-web 第 2 節

第 2 節聚焦 pi-web 的 README 線索：ote machines from one web UI. Your browser is the control surface. The work stays where it can keep running. Quick start Requirements: - Node.js 22.19.0 or newer - npm - Pi Coding Agent =0.84.0 , configured for your user - git and the development tools your agents need Install and start PI WEB as per-user services: bash npm install -g @jmfederico/pi-web --allow-scripts=node-pty pi-web install pi-web doctor On npm 12, the scoped flag lets node-pty prepare its required native module without enabling install scripts for other dependencies. Then open: text http://127.0.0.1:8504 Useful commands: bash pi-web status pi-web logs pi-web restart pi-web doctor pi-web version pi-web uninstall !-- Keep README guidance concise. Put install variants, troubleshooting, configuration, and operational details in docs/, then link from here. -- For more install options, including one-line install, Pi package install, WSL/manual usage。這段材料說明專案目前公開的用途與操作語境，本文只依照儲存庫材料整理，不把描述延伸成 README 沒有承諾的能力。

對使用者而言，第 2 節的線索要放回完整流程理解。可以從 jmfederico/pi-web 的 README、設定檔與範例名稱開始，確認輸入如何進入 pi-web，中間產生什麼可見結果，以及輸出是否符合自己的工作環境。若材料沒有交代某項行為，應保留為未說明，而不是用相近工具的經驗補上。

評估 pi-web 的第 2 個檢查點是：, and remote access, see the installation guide https://pi-web.dev/install . Core model PI WEB organizes work like this: text Machine a local or remote PI WEB runtime endpoint Project a folder on that machine Workspace a provider-owned working folder; bundled Git discovers worktrees, otherwise the project folder Session a Pi Coding Agent chat running inside a workspace A typical flow: 1. Add a project. 2. Choose a workspace or git worktree. 3. Start a session. 4. Let the agent work. 5. Come back later from any browser. Remote-first development PI WEB is designed for remote AI-driven development. Instead of tying agent work to your laptop session, run PI WEB on a machine that stays available: a server, desktop, cloud VM, home lab machine, or remote dev box. Use a private network, SSH tunnel, trusted reverse proxy, or federated PI WEB machine setup when accessing it remotely. Read more: Remote-first development htt。這比只看 stars 或一句功能摘要更有辨識力，也能把版本差異、權限、資料格式或外部服務依賴及早暴露。實際記錄時，請把輸入、輸出、錯誤訊息和執行環境分開保存，方便回頭對照這個專案自己的行為。每節都應保留專案名稱與具體檔案或指令，這樣後續核對不會只剩抽象印象。

資料與設定的具體形狀：pi-web 第 3 節

第 3 節聚焦 pi-web 的 README 線索：, and remote access, see the installation guide https://pi-web.dev/install . Core model PI WEB organizes work like this: text Machine a local or remote PI WEB runtime endpoint Project a folder on that machine Workspace a provider-owned working folder; bundled Git discovers worktrees, otherwise the project folder Session a Pi Coding Agent chat running inside a workspace A typical flow: 1. Add a project. 2. Choose a workspace or git worktree. 3. Start a session. 4. Let the agent work. 5. Come back later from any browser. Remote-first development PI WEB is designed for remote AI-driven development. Instead of tying agent work to your laptop session, run PI WEB on a machine that stays available: a server, desktop, cloud VM, home lab machine, or remote dev box. Use a private network, SSH tunnel, trusted reverse proxy, or federated PI WEB machine setup when accessing it remotely. Read more: Remote-first development htt。這段材料說明專案目前公開的用途與操作語境，本文只依照儲存庫材料整理，不把描述延伸成 README 沒有承諾的能力。

對使用者而言，第 3 節的線索要放回完整流程理解。可以從 jmfederico/pi-web 的 README、設定檔與範例名稱開始，確認輸入如何進入 pi-web，中間產生什麼可見結果，以及輸出是否符合自己的工作環境。若材料沒有交代某項行為，應保留為未說明，而不是用相近工具的經驗補上。

評估 pi-web 的第 3 個檢查點是：ps://pi-web.dev/remote-first Machines and fleets PI WEB can register other PI WEB runtimes as remote machines. One browser-facing PI WEB instance can proxy projects, files, git state, sessions, terminals, activity, Pi package management, and selected-machine settings from trusted remote machines. When a remote machine is selected, Settings tabs label their target. Pi packages, PI WEB plugin enablement, session daemon toggles, external file access, and upload defaults target the selected machine. Gateway/server settings such as host, port, allowed hosts, registered machines/tokens, and keyboard shortcuts stay local to the gateway/browser. Read more: Fleet and machines guide https://pi-web.dev/machines PI WEB plugins PI WEB supports trusted browser plugins plus optional sessiond-backed workspace providers. Bundled Git uses the same public provider and backend contracts available to installed plugins. Use Settings →。這比只看 stars 或一句功能摘要更有辨識力，也能把版本差異、權限、資料格式或外部服務依賴及早暴露。實際記錄時，請把輸入、輸出、錯誤訊息和執行環境分開保存，方便回頭對照這個專案自己的行為。每節都應保留專案名稱與具體檔案或指令，這樣後續核對不會只剩抽象印象。

維護與相容性線索：pi-web 第 4 節

第 4 節聚焦 pi-web 的 README 線索：ps://pi-web.dev/remote-first Machines and fleets PI WEB can register other PI WEB runtimes as remote machines. One browser-facing PI WEB instance can proxy projects, files, git state, sessions, terminals, activity, Pi package management, and selected-machine settings from trusted remote machines. When a remote machine is selected, Settings tabs label their target. Pi packages, PI WEB plugin enablement, session daemon toggles, external file access, and upload defaults target the selected machine. Gateway/server settings such as host, port, allowed hosts, registered machines/tokens, and keyboard shortcuts stay local to the gateway/browser. Read more: Fleet and machines guide https://pi-web.dev/machines PI WEB plugins PI WEB supports trusted browser plugins plus optional sessiond-backed workspace providers. Bundled Git uses the same public provider and backend contracts available to installed plugins. Use Settings →。這段材料說明專案目前公開的用途與操作語境，本文只依照儲存庫材料整理，不把描述延伸成 README 沒有承諾的能力。

對使用者而言，第 4 節的線索要放回完整流程理解。可以從 jmfederico/pi-web 的 README、設定檔與範例名稱開始，確認輸入如何進入 pi-web，中間產生什麼可見結果，以及輸出是否符合自己的工作環境。若材料沒有交代某項行為，應保留為未說明，而不是用相近工具的經驗補上。

評估 pi-web 的第 4 個檢查點是： PI WEB plugins to manage desired state on the selected machine. Pi packages are a separate Pi package-manager concept. A Pi package may include a PI WEB plugin, but installing a package and enabling it are different operations. Server-backed changes require a session-daemon restart; see the plugin guide for lifecycle and recovery details. Read more: PI WEB plugin guide and API https://pi-web.dev/plugins Configuration Global config lives at: text $PI WEB CONFIG ~/.config/pi-web/config.json Project-local PI WEB config lives at: text project /.pi-web/config.json Common configuration includes host/port, path access, uploads, PI WEB plugin enablement, shortcuts, and session daemon options. In Settings, machine-affecting config targets the selected machine; gateway host/port/allowed-hosts, remote machine registration, tokens, and keyboard shortcuts stay local. Read more: Configuration reference https://pi-web.dev/conf。這比只看 stars 或一句功能摘要更有辨識力，也能把版本差異、權限、資料格式或外部服務依賴及早暴露。實際記錄時，請把輸入、輸出、錯誤訊息和執行環境分開保存，方便回頭對照這個專案自己的行為。每節都應保留專案名稱與具體檔案或指令，這樣後續核對不會只剩抽象印象。

從指令或檔案開始核對：pi-web 第 5 節

第 5 節聚焦 pi-web 的 README 線索： PI WEB plugins to manage desired state on the selected machine. Pi packages are a separate Pi package-manager concept. A Pi package may include a PI WEB plugin, but installing a package and enabling it are different operations. Server-backed changes require a session-daemon restart; see the plugin guide for lifecycle and recovery details. Read more: PI WEB plugin guide and API https://pi-web.dev/plugins Configuration Global config lives at: text $PI WEB CONFIG ~/.config/pi-web/config.json Project-local PI WEB config lives at: text project /.pi-web/config.json Common configuration includes host/port, path access, uploads, PI WEB plugin enablement, shortcuts, and session daemon options. In Settings, machine-affecting config targets the selected machine; gateway host/port/allowed-hosts, remote machine registration, tokens, and keyboard shortcuts stay local. Read more: Configuration reference https://pi-web.dev/conf。這段材料說明專案目前公開的用途與操作語境，本文只依照儲存庫材料整理，不把描述延伸成 README 沒有承諾的能力。

對使用者而言，第 5 節的線索要放回完整流程理解。可以從 jmfederico/pi-web 的 README、設定檔與範例名稱開始，確認輸入如何進入 pi-web，中間產生什麼可見結果，以及輸出是否符合自己的工作環境。若材料沒有交代某項行為，應保留為未說明，而不是用相近工具的經驗補上。

評估 pi-web 的第 5 個檢查點是：ig Development Clone the repository and run: bash npm install npm run dev Open the Vite URL, usually: text http://localhost:8505 For the split development setup: bash npm run dev:sessiond npm run dev:web npm run dev:client Validate changes with: bash npm run verify Security model PI WEB assumes trusted users, trusted repositories, and trusted server paths. It is not a sandbox, permission system, or multi-tenant platform. Do not expose it directly to the public internet without a trusted network, firewall, VPN, SSH tunnel, or authenticated reverse proxy. Documentation - Website https://pi-web.dev/ - Install https://pi-web.dev/install - Remote-first development https://pi-web.dev/remote-first - Machines / fleet https://pi-web.dev/machines - Configuration https://pi-web.dev/config - Plugins https://pi-web.dev/plugins - FAQ https://pi-web.dev/faq License MIT 2026 Federico Jaramillo Martinez. See LICENSE LICENSE .。這比只看 stars 或一句功能摘要更有辨識力，也能把版本差異、權限、資料格式或外部服務依賴及早暴露。實際記錄時，請把輸入、輸出、錯誤訊息和執行環境分開保存，方便回頭對照這個專案自己的行為。每節都應保留專案名稱與具體檔案或指令，這樣後續核對不會只剩抽象印象。

適用對象與明確界線：pi-web 第 6 節

第 6 節聚焦 pi-web 的 README 線索：ig Development Clone the repository and run: bash npm install npm run dev Open the Vite URL, usually: text http://localhost:8505 For the split development setup: bash npm run dev:sessiond npm run dev:web npm run dev:client Validate changes with: bash npm run verify Security model PI WEB assumes trusted users, trusted repositories, and trusted server paths. It is not a sandbox, permission system, or multi-tenant platform. Do not expose it directly to the public internet without a trusted network, firewall, VPN, SSH tunnel, or authenticated reverse proxy. Documentation - Website https://pi-web.dev/ - Install https://pi-web.dev/install - Remote-first development https://pi-web.dev/remote-first - Machines / fleet https://pi-web.dev/machines - Configuration https://pi-web.dev/config - Plugins https://pi-web.dev/plugins - FAQ https://pi-web.dev/faq License MIT 2026 Federico Jaramillo Martinez. See LICENSE LICENSE .。這段材料說明專案目前公開的用途與操作語境，本文只依照儲存庫材料整理，不把描述延伸成 README 沒有承諾的能力。

對使用者而言，第 6 節的線索要放回完整流程理解。可以從 jmfederico/pi-web 的 README、設定檔與範例名稱開始，確認輸入如何進入 pi-web，中間產生什麼可見結果，以及輸出是否符合自己的工作環境。若材料沒有交代某項行為，應保留為未說明，而不是用相近工具的經驗補上。

評估 pi-web 的第 6 個檢查點是：PI WEB https://github.com/jmfederico/pi-web/actions/workflows/ci.yml https://www.npmjs.com/package/@jmfederico/pi-web package.json LICENSE PI WEB is a web UI for Pi Coding Agent https://github.com/earendil-works/pi/tree/main/packages/coding-agent that keeps agent sessions running in real workspaces on your machine or server. Run agents where your code, tools, credentials, and build caches live. Supervise them from any browser. Website and docs: https://pi-web.dev/ Why PI WEB? Agentic development works better when the work environment is persistent. PI WEB lets you: - keep Pi Coding Agent sessions alive after browser disconnects; - run agents inside real repositories and git worktrees; - supervise multiple sessions in parallel; - switch between laptop, phone, tablet, and desktop; - use a server, workstation, or remote dev box as your agent runtime; - manage projects, workspaces, files, terminals, sessions, and rem。這比只看 stars 或一句功能摘要更有辨識力，也能把版本差異、權限、資料格式或外部服務依賴及早暴露。實際記錄時，請把輸入、輸出、錯誤訊息和執行環境分開保存，方便回頭對照這個專案自己的行為。每節都應保留專案名稱與具體檔案或指令，這樣後續核對不會只剩抽象印象。

編輯結論

適合需要 用瀏覽器監督持久執行的 Pi Coding Agent 工作階段 的使用者，尤其是願意依 pi-web README 的指令、檔案或設定逐步核對輸入輸出的人；不適合把儲存庫摘要當成完整產品保證。先在符合 README 條件的環境執行最小範例，檢查專案自己的輸出、錯誤訊息與版本相容性，再決定是否放入正式流程。

官方來源

1. Official documentation
2. Official README
3. Project repository
4. Release notes