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。