Pi Coding Agent 的開源應用程式

Pi 不隨附模型，而這正是在這裡執行它的有趣之處：Happier 保存的每個代理程式憑證，都是 Pi 會接受的那一種。Claude 訂閱設定檔、Anthropic 金鑰、Codex 登入和 OpenAI 金鑰全都可用，所以你因為使用 Claude Code 而組起來的帳號池，也能驅動這個——在工作階段開始時選定，而不是由那台電腦上次登入的東西決定。

這個機制值得用句話說明，因為它解釋了什麼會動、什麼不會動。啟動之前，Happier 會把你挑的設定檔以 Pi 期待的形狀寫進 Pi 自己隔離的憑證檔：訂閱登入變成 OAuth 憑證，setup token 或 API 金鑰變成金鑰。接著 Pi 讀它自己的檔案，直接與供應商通訊，你的請求不會經過我們的任何東西。如果你有數個設定檔都符合，應用程式會問你要哪一個，而不是替你挑。

這一個沒有登入按鈕，那是 Pi 的緣故，不是遺漏：它沒有暴露可供 Happier 驅動的互動式登入，所以供應商頁面只回報那台電腦既有的、來自環境的憑證，到此為止。引導確實可用——送進已經在執行的回合裡的訊息會被代理程式接走，而不是排在它後面等——但往廠商終端機裡打字不是這個代理程式提供的功能。Pi 在 Happier 裡是實驗性的供應商，這就是閱讀它時該有的狀態認知。

Pi 是自備金鑰的終端機程式設計代理程式：它不隨附模型，你有哪個供應商的憑證，它就驅動哪個。happier pi 會用你 shell 既有的環境，在你的儲存庫裡執行它。

那正好貼合 Happier 的運作方式，因為 Happier 同樣不保存那些金鑰。代理程式行程在你的電腦上讀取它們，直接與供應商通訊；跨過網路的只有加密的對話紀錄，而且是送往你自己的裝置。

所以 Pi 工作階段的形狀是：你的金鑰、你的電腦、你的儲存庫，以及口袋裡能讀取並回覆對話的手機。這份清單上沒有任何東西是向我們租的；如果你寧可不用我們的，中間的中繼伺服器也可以是你自己跑的那一台。

iOS 和 Android 應用程式、macOS、Windows 和 Linux 的桌面應用程式，以及 app.happier.dev，全都是連向你電腦上執行中的 Pi Coding Agent 行程的用戶端 — 不是唯讀的鏡像。回應權限請求、送出下一則指示、瀏覽儲存庫、閱讀差異。對話紀錄在離開你的電腦前就已端對端加密，所以承載它的伺服器持有的是密文。

Happier 安裝在已經放著你儲存庫的那台電腦上，而 happier pi 會在那裡以一般子行程的方式啟動 Pi Coding Agent，在你指定的目錄裡，並以你當初登入的方式登入。代理程式和 Pi 之間沒有閘道，你的原始碼在其他任何地方也沒有副本。

Happier 會先在你的 PATH 上找 pi，執行你裝的那份。如果沒有，它可以把 @earendil-works/pi-coding-agent 安裝到 ~/.happier/tools/providers/pi/ — 那是它自己的目錄，不是你全域的 npm prefix。你自己管理的那份，永遠不會在你不知情的情況下被取代或升級。

Pi 自己的安裝與登入指南在 github.com/badlogic/pi-mono。Happier 不會鏡像一份，因為把別人的安裝說明抄一份過來，抄的就是一份會過期的東西。

Happier 這一側的設定參考 — Happier 文件中的 Pi Coding Agent。

Pi Coding Agent 是 Happier 可以指向「你連結過一次的憑證」的代理程式之一，而不是指向那台電腦當下登入的帳號。它接受 a Codex subscription, an OpenAI API key, a Claude subscription or an Anthropic API key。

已連結服務是以憑證為鍵，而不是以代理程式為鍵，所以同一份 Codex subscription 在每一台你連結過的電腦上，都能給任何接受它的代理程式選用 — 這也正是把你自己的帳號組成一個池、跨多台電腦使用會有幫助的原因。憑證的加密與解密都在你自己的裝置上進行；文件頁面 記載各種設定檔的規則，因為每個代理程式接受哪些種類的設定檔，正是會隨版本變動的那類細節。

Pi Coding Agent 是 Happier 執行的 13 個命令列程式設計代理程式之一，它們共用同一份工作階段清單、同一個權限收件匣、同一套鍵盤快速鍵和同一份 MCP 設定。

You define an MCP server once, and because Pi Coding Agent does not consume MCP directly, Happier hands the same tool surface to it through the happier tools shell bridge instead — the same tools, delivered as commands it can run. The app previews the effective tool surface before a session starts, so which one you got is visible rather than inferred.

這在你同時跑不只一個的日子最重要：不同供應商的工作階段並排在一起，而點一下通知會開啟提出該請求的工作階段，而不是應用程式的大門。完整清單在這裡。

在終端機輸入 happier pi 就會在你所在的地方啟動工作階段，而同一個工作階段同時也在應用程式裡。你在那個 shell 裡讀到的是 Happier 自己對該工作階段的顯示 — 對話紀錄、權限提示、工具輸出 — 而不是 Pi Coding Agent 的介面。沒有人得放棄終端機才能得到一個手機用戶端。

沒有交接到 Pi Coding Agent 自己 TUI 這回事。那是 Claude Code、Codex 和 OpenCode 才有的；用 Pi Coding Agent 時，工作階段兩端都還是 Happier 的。happier attach <session-id> 會列出那台電腦上的工作階段，並標記它無法重新接上的那些，而不是等你選了之後才失敗。

attach 指南列出了各種情況，而不是承諾全部都行。

在放著你程式碼的電腦上執行一道指令，然後在你想工作的儲存庫裡執行 happier pi。

逐步說明在指南裡。全部都採 MIT 授權，而中繼站是你可以自己執行的。