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 文件来定义无法绕过的写入限制。