codewhale-hq/Codewhale

解决的问题

Codewhale 是一款基于终端的编码代理，通过读取仓库、编辑文件和执行 shell 命令来自动化软件开发任务。它充当自主助手，可以处理复杂的编码目标、修复错误并运行测试，让您在处理实现细节的同时留在终端中。

工作原理

Codewhale 作为命令行界面（CLI）运行，连接 40 多个 AI 模型提供商（例如 OpenAI、Anthropic，或通过 Ollama 提供的本地模型）。您提供任务，代理以三种模式之一运行：Plan（仅读取和搜索）、Work（编辑文件和运行命令）或 Operate（追求目标直至完成的自主循环）。它维护所有操作的详细日志，称为“收据”，跟踪文件更改、命令执行和工具调用，让您可以轻松审核或撤销更改。

适用人群

它专为喜欢在终端中工作、并希望将 AI 驱动的编程伙伴集成到现有工作流程中的开发者设计。对于希望自动化重复性编码任务、进行 PR 审查，或在不离开命令行环境的情况下尝试不同 LLM 的用户尤其有用。

亮点

• 多模型支持： 兼容 40+ 提供商以及通过 Ollama、vLLM 或 SGLang 提供的本地模型。
• 灵活权限： 对代理自主性提供细粒度控制，范围从手动批准（Ask）到完全自动化（Full Access）。
• 安全优先设计： 包含内置的 OS 沙箱（通过 Seatbelt 或 bubblewrap），限制代理访问敏感凭据和文件。
• 可扩展架构： 支持 MCP（模型上下文协议）服务器、自定义插件和技能以扩展功能。
• 可审计性： 提供全面的“收据”系统，跟踪代理执行的每个操作，并内置撤销功能。