pi (earendil-works/pi) — 極簡可擴展 AI Coding Agent 深度分析

TypeScript 原生的極簡 AI agent 工具包，核心是一個可自修改的 coding agent CLI，加上統一 LLM API、TUI 函式庫、Slack bot，以及一套完整的 extension/skill 生態。

架構總覽

套件	用途
pi-ai	統一多 provider LLM API（OpenAI、Anthropic、Google、xAI…）
pi-agent-core	Agent runtime：tool calling、狀態管理、權限控制
pi-coding-agent	互動式 CLI coding agent，可讀寫檔案、執行 shell、改自己的原始碼
pi-tui	Terminal UI 函式庫，差異化渲染（differential rendering）

與其他 Coding Agent 的核心差異

1. 極簡核心 + 全系統權限 Extension

pi 刻意不內建 MCP、sub-agent、plan mode、permission popup、to-do 等功能。這些全部靠 extension 實作。Extension 以 TypeScript 模組載入，擁有完整系統權限——可註冊自訂工具、指令、快捷鍵、UI 元件，甚至替換內建工具、實作自訂壓縮邏輯、整合 SSH/Git checkpoint。

這和 Claude Code（開箱即用、內建一切）走相反路線。pi 的哲學是「給開發者最大的自由度，不做預設」。

2. Agent Skills 標準 + Pi Packages 生態

pi 實作了 Agent Skills 標準（/skill:name），可定義 prompt template、技能包、主題。Extension、skill、prompt template、theme 可以打包成 Pi Package，透過 npm 或 git 分享。

這建立了一個社群驅動的生態系——不是廠商決定你要用什麼功能，而是社群貢獻各種 extension。

3. Session 持久化 + 分支

pi 以 JSONL 儲存 session 歷史，支援 /tree（瀏覽對話分支）和 /fork（建立分支）。這讓開發者可以從過去的對話點分叉出新的探索路徑，而不破壞原始 session。

4. 自修改能力

pi 的 coding agent 可以直接修改 pi 自己的原始碼。這是「dogfooding」的極致——開發 pi 的人用 pi 開發 pi。

5. SDK 和 RPC 模式

除了 CLI，pi 提供 SDK 嵌入其他應用、RPC 模式整合非 Node.js 環境。這讓 pi 不只是終端機工具，而可以作為其他系統的 agent 後端。

供應鏈安全

對我們技術棧的價值評估

評估維度	判斷	說明
取代 Claude Code / Codex CLI	不建議	TypeScript 原生，我們 Python 為主；遷移成本高，成熟度不如 Claude Code
作為額外 coding agent 選項	低價值	多一個 agent 多一份維運成本，無明顯優勢
pi-ai 作為 LLM 抽象層	不需要	Hermes + LiteLLM 已覆蓋多 provider 需求
pi-tui 終端機 UI	暫無需求	目前沒有 TUI 應用場景
Extension 架構借鑒	有價值	極簡核心 + extension 的設計哲學可參考
供應鏈安全實踐	高價值	可直接搬到 dky-tools 的 CI/CD
AGENTS.md 規範	有價值	可為我們的 repo 建立類似的 agent 協作文件

結論

pi 設計精良，哲學清晰（Unix 式極簡 + 可擴展），社群活躍（60.9K 星、212 貢獻者、227 次 release）。但它解決的問題我們已用 Hermes + Claude Code/Codex CLI 覆蓋。最大價值不在採用，而在借鑒：供應鏈安全做法、AGENTS.md 規範、極簡核心的設計決策。

如果未來有大規模 TypeScript 專案需要 coding agent，或是 Agent Skills 標準成為跨工具通用格式，pi 會是第一選擇。