Agent Code – 用於管理 AI 編碼代理的開源 Mac 應用

Agent Deck 是一款為 Pi 編碼代理提供原生 macOS 界面的開源應用。它並不替代 Pi 或嵌入自己的代理運行時，而是啓動已安裝的 pi CLI 的 JSONL RPC 模式，管理周邊資源和用户界面，併為 Pi 傳遞所需標誌。結果既是為 Pi 會話提供的原生控制表面，也是組織代理、技能、提示和工作流的平台。

安裝方面，用户可通過 Releases 頁面下載最新簽名的 .dmg 文件並拖入 Applications 文件夾。更新通過 Sparkle 自動推送。需要 macOS 26 (Tahoe) 和 Apple Silicon，且 Pi CLI 需安裝並可被找到——首次啓動時內置的 Doctor 工具會引導用户完成設置。

Agent Deck 的設計保證了範圍始終可見：每個代理、技能和提示都會顯示其來源（內置、全局、庫或項目），並帶有彩色標籤、圖標和文字。分配是顯式的：Agent Deck 啓動 Pi 時會使用 --no-skills 等標誌，僅選擇性啓用已分配的內容。內置項為只讀：自定義時會寫入覆蓋文件，原始文件不會被修改。所有寫入操作都會顯示將要寫入的內容和位置。

會話與轉錄方面，支持流式轉錄，包含引導消息、思考塊、工具調用、計劃、內聯差異、文件預覽和顏色編碼狀態。實時計劃清單跟蹤代理的待辦/進行中/完成/阻塞/跳過狀態。豐富的編輯器支持粘貼處理、@ 文件建議、macOS 聽寫和附件。通過 Apple 的本地基礎模型自動命名會話。空閒時自動釋放系統資源。需要命令行調試時可通過終端交接。

並行工作方面，每個新會話可以在 Application Support 下創建獨立的 Git 分支和工作樹。用户可以在同時間運行三個代理處理三個功能，互不干擾。專用的 Merge 工具欄操作可將工作合併回源分支，並可配置工作樹和分支的保留或丟棄。

端到端的 GitHub 集成包括：問題看板（打開/關閉列、子問題進度、依賴追蹤、跨倉庫搜索）、一鍵將問題轉為會話（標題、正文、標籤、評論作為上下文加載），以及通過 gh CLI 或原生 OAuth 進行 GitHub 認證。

子代理功能讓父會話保持編排優先：將探索、規劃、實現、審查等範圍工作委託給原生子代理。內置啓動包包括探索者、規劃者、編碼者、審查者。轉錄中摘要卡片顯示每個代理的狀態、令牌數和持續時間。當子代理需要人類指導時，超級請求卡片會呈現原生 macOS 決策界面。支持並行和鏈式圖形。

代理、技能、提示和命令均在側邊欄中瀏覽和切換。技能可以從任何文件夾、GitHub 倉庫或 skills.sh URL 通過無 blob 的稀疏克隆導入。導入時 Agent Deck 會生成 AI 摘要，幫助用户瞭解不熟悉的技能。可同步上游並解決衝突。提示是可重複使用的起點。代理包含名稱、描述、系統提示覆蓋、工具限制、模型覆蓋、思考級別和生成的頭像。

記憶功能為每個項目保留決策、操作手冊、架構和先前失敗，由代理在會話期間通過 agent_deck_memory_write 工具寫入，存儲為 Markdown，並在未來會話中根據預算注入。過時記憶會被標記為過時，不會刪除。秘密掃描會阻止記憶寫入看起來像私鑰、GitHub 令牌等敏感信息。

自動化功能由 Apple 基礎模型本地免費運行：會話標題起草、提交消息生成、頭像提示、技能導入摘要。每項自動化都有獨立的模型選擇器。

模型和提供者方面，自動發現配置的 Pi 提供者的模型。按提供者分組。可設置默認值、按代理和按會話覆蓋。隱藏未使用的條目。環境視圖管理 .env 文件，支持秘密遮蔽。

健康與設置方面，Doctor 運行健康檢查，包括 Pi CLI、版本、路徑解析和必需的環境密鑰，並提供自動修復建議。包含 6 頁歡迎導覽和逐步設置嚮導。

文檔涵蓋系統提示邏輯、Pi RPC 啓動標誌、技能和模型參考、記憶設計、資源刷新和文件監視等。要求 macOS 26 (Tahoe)、Apple Silicon、Xcode 26.4+ 和 Pi CLI。許可證為 MIT。