codewhale

Codewhale是一个在终端运行的开源编码代理。它用Rust编写，可读取项目、编辑文件、运行命令，并通过用户选择的托管或本地模型检查自身工作。该项目最初名为`deepseek-tui`，保留了配置和会话兼容性，但现在为无特定提供方的独立维护项目，与任何模型提供方无关联。 macOS和Linux的安装通过官方安装脚本完成，自动选择最新发布的版本；Windows用户可从GitHub Releases下载安装程序或存档文件。更新命令可检查并应用新版本。npm和Cargo作为次要打包方式支持，同时兼容Docker、Nix、Scoop、Android/Termux和可选的CNB镜像。每种shell都会生成自动补全功能。 使用时需在项目文件夹内运行`codewhale`，通过`/provider`选择提供方、`/model`选择模型，然后描述具体任务。任务也可通过`codewhale exec`非交互式运行，适用于脚本和CI流程。代理可读取仓库、编辑文件、运行命令、检查结果并持续向目标推进。计划模式允许探索而不修改文件或执行shell，工作模式允许修改；键盘快捷键可在询问、自动审查和全权限模式间切换。 除终端界面外，内置的本地网页客户端连接到同一Codewhale运行时，图形化网页和桌面工作台正在开发中。社区维护的VS Code扩展可从侧边栏连接本地运行时。源代码包含的计算机使用插件添加了观察和交互其他应用的工具，需符合操作系统权限和平台要求。 显著功能包括通过Ollama、vLLM或SGLang连接托管提供方或本地模型；检查拟议操作和文件变更；即使在全权限下也具有硬性策略边界的审批设置；工作区变更的撤销与恢复；保存的会话、持久化目标、执行前的工作流审查，以及协调不同模型和角色的代理；通过MCP服务器、技能、钩子和可读代理角色文件进行扩展。未知模型价格会报告为未知而非免费。 文档涵盖提供方和本地模型、代理团队、MCP、钩子、配置、本地网页客户端、授权顺序、模式和权限、安装及仓库结构。该项目采用MIT许可证，记录了第三方通知，并欢迎提交错误报告、功能建议和拉取请求。