Hmbown/CodeWhale

Open-source, community-driven agent harness

解決的問題

Codewhale 是一個基於終端機的程式設計代理，允許開發者直接從命令列自動執行軟體工程任務。它透過允許使用者「帶入您自己的模型（bring your own model）」，消除了對單一 AI 模型提供商的依賴，將各種託管和本地 LLM 整合到一個用於編輯檔案和執行指令的統一工具集中。

工作原理

該代理透過讀取您的程式碼、編輯檔案和執行 shell 指令來完成給定任務。它可以透過終端機使用者介面 (TUI) 進行互動式使用，或者透過 codewhale exec 指令進行無頭（headless）執行，用於腳本和 CI/CD 流水線。它支援廣泛的提供商（包括 DeepSeek、Claude、GPT 以及本地選項如 Ollama 或 vLLM），並允許使用者使用 /model 指令在任務中途切換模型。

適用對象

想要一個可以在本地機器上執行，並對權限和安全沙箱提供細粒度控制的模型無關程式設計代理的開發者。

亮點

  • 模型無關: 支援 30 多個提供商，包括託管服務和本地 LLM。
  • 安全第一: 包括唯讀的「Plan」模式、危險指令的核准閘門以及作業系統級沙箱（macOS 上的 Seatbelt，Linux 上的 bubblewrap）。
  • 可續行的工作: 使用僅限追加的日誌記錄每一步，允許使用者透過 fleet resume 恢復任務。
  • 多介面: 提供 TUI、無頭執行模式和本地瀏覽器用戶端。
  • 基於憲法的控制: 支援使用 constitution.json 檔案來定義無法規避的寫入限制。