ControlKeel
把团队的工程习惯转化为可执行的策略、审查关卡与持久化证据。
- Star 数
- ★ 11
- 最近更新
- 5 天前
- License
- NOASSERTION
- 主语言
- Elixir
- FA 评分
- 58/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台CodexClaude Code(部分支持)
- 费用
- 有免费版,另有付费云服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 已经使用 Codex、Claude、OpenCode 或其他受支持宿主的开发团队,希望在代理生成的变更进入主分支前执行统一策略检查。
- 不适合
- 需要完全离线、数据绝不离开本机的团队(云遥测、工作区密钥、回调等路径会把证据送出本地)
- 希望安装后零人工介入、无需工作区信任或主机重启即可全自动运行的团队
- 需要明确开源许可证条款才能合规采用的团队(许可证为 NOASSERTION)
- 官网
- controlkeel.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-15最新版本 v0.4.21(2026-09-25)
- 源码审查
- 58/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
ControlKeel 是面向 AI 编码代理的工程治理控制平面,用于比较预期交付与实际变更,并在风险工作进入主分支前实施检查。它提供 CLI、本地 stdio MCP 工具集、项目绑定、宿主接入与运行时导出,同时记录 findings、reviews、proof bundles、budgets、typed memory 和任务结果。其工作流先捕获范围、风险、预算、领域规则与人工评审偏好,再执行确定性验证和可选的咨询式审查,并在策略要求时加入人工批准。证据可以保存在本地,也可通过选择启用的云端遥测、workspace keys、cloud run packages 和回调路径参与同步。项目使用 Phoenix、Ecto 和 SQLite 开发,并通过 Burrito 与 GitHub Releases 提供单一二进制构建。
ControlKeel 通过 controlkeel setup 为当前代码库建立治理状态,再以 controlkeel attach <host> 接入受支持的编码代理宿主;如果只有 MCP 可用,则调用 ck_attach。controlkeel attach doctor 检查宿主接入,controlkeel provider doctor 检查 provider 配置,controlkeel status 显示状态,controlkeel findings 输出检查发现。运行时会读取已捕获的范围、风险、预算、domain pack 与人工偏好,对代理产出的变更执行确定性扫描和可选咨询式审查,根据策略决定是否阻断或要求人工批准,并持久化发现、审查、证明包、记忆、成本和任务结果。其可观测性流程还整理时间线、成本趋势、问题集群、评测候选、基准草案与晋升建议,使反复出现的问题能够转化为有回归证据支持的确定性检查。
- 已经使用 Codex、Claude、OpenCode 或其他受支持宿主的开发团队,希望在代理生成的变更进入主分支前执行统一策略检查。
- DevSecOps 团队需要把安全、合规或交付规则编码为可阻断高风险操作的治理关卡,并保留 findings 与 proof bundles。
- 频繁更换代理宿主的工程组织,希望通过项目绑定、MCP、宿主接入和运行时导出保存跨宿主的审查证据与 typed memory。
- 维护大量领域约定的团队,希望把反复向模型解释的评审偏好和交付习惯沉淀为可执行检查。
- 负责代理质量评估的团队,希望把运行轨迹和重复失败转化为特定 suite 与 subject 的回归证据和基准历史。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm i -g @aryaminus/controlkeelcurl -fsSL https://github.com/aryaminus/controlkeel/releases/latest/download/install.sh | shirm https://github.com/aryaminus/controlkeel/releases/latest/download/install.ps1 | iex
- 安装说明涉及
- Windows · macOS
如何安装或部署这个 Agent?
可选择以下任一已记录的安装方式。源码没有给出 Node.js、Homebrew 或操作系统的最低版本,也没有说明本地首次运行必须提供哪些凭据。
使用 Homebrew:
brew tap aryaminus/controlkeel && brew install controlkeel使用 npm:
npm i -g @aryaminus/controlkeel使用发布页安装脚本:
curl -fsSL https://github.com/aryaminus/controlkeel/releases/latest/download/install.sh | shWindows PowerShell:
irm https://github.com/aryaminus/controlkeel/releases/latest/download/install.ps1 | iex若从源码开发,需要 Elixir 的 Mix 工具链;仓库给出的开发命令为:
mix setup
mix phx.server
mix test
mix precommit如何使用这个 Agent?
在需要治理的代码库目录中执行首次配置和宿主接入。下面使用 README 中明确给出的 OpenCode 示例;其他宿主应替换为其受支持的 host 名称。
controlkeel
controlkeel setup
controlkeel attach opencode
controlkeel attach doctor
controlkeel provider doctor
controlkeel status
controlkeel findings项目作用域默认只在当前仓库内写入宿主文件。仅当目标明确支持用户作用域时,才可使用 --scope user 写入用户配置;这不会把项目绑定或 proof 状态变成全局状态。接入或插件发生变化后需要重启宿主;若宿主要求 workspace trust、手动 provider 配置、重启或无法自动等待的计划审批,应先完成相应人工操作。如果环境只暴露 MCP,则为当前宿主调用 ck_attach。
这个 Agent 有哪些优点和局限?
- 同时提供 CLI、本地 stdio MCP、宿主接入和运行时导出,适合在不同代理宿主之间保留治理流程。
- 不仅生成建议,还能执行确定性策略检查、按风险阻断操作,并持久化 findings、reviews 和 proof bundles。
- 把 typed memory、成本、任务结果和评测证据纳入同一反馈循环,可将重复失败推进为有回归证据的检查。
- 公开的限定基准显示,在
host_comparison_v1的 12 个风险场景中,版本 0.3.45 的确定性验证捕获 12/12、阻断 9/12,且未消耗 provider tokens。
- 宿主能力并不统一:README 明确区分原生接入、较窄的 OAuth 托管 MCP、最小化 A2A 以及回退验证或代理路径,采用前需要核对具体宿主支持层级。
- 首次接入可能需要 workspace trust、手动 provider 配置以及宿主重启,无法保证完全无人值守。
- 公开基准只覆盖具名 suite、subject 和评分定义;确定性扫描结果不能视为模型驱动宿主在所有真实项目中的效果证明。
- 仓库许可证标记为
NOASSERTION,来源材料未提供可据以确认的授权条款,组织采用前需要单独核实。 - 双向云同步默认休眠,必须先配置;使用云端证据路径还会引入 workspace keys、遥测和运行时回调方面的部署决策。
这个 Agent 与同类方案有什么区别?
与只在 *.md 中告诉模型如何行动相比,ControlKeel 的定位是检查代理实际产出,并把规则落实为 typed memory、策略检查、发现记录和证明包。其公开的 host_comparison_v1 基准中,null_policy_baseline 捕获 0/12 个风险场景,而 controlkeel_validate 捕获 12/12;这一比较仅适用于该具名测试套件,不能外推为所有宿主或所有代码库的总体效果。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| ControlKeel 当前 | 58 · 缺口较多 | 命令行工具免费版 + 付费版 | ★ 11 | 5 天前 | Elixir | Codex |
| Alas 智能编程工作区 | 79 · 表现良好 | 桌面应用免费 + 模型费 | ★ 25 | 今天 | Swift | Codex · Claude Code |
| Jev Review | 62 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 253 | 2 个月前 | TypeScript | Codex · Claude Code |
| AgentCrew 多智能体工作台 | 61 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 226 | 1 天前 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 和入门文档说明项目级 attach 默认只修改受治理仓库,用户级配置受 host 支持范围约束;高影响操作需要人工审批,因此最小权限和确认机制有实质支持,但具体工具权限与审批实现未在样本代码中展示,未给满分。文档区分本地完整 MCP 与较窄的 hosted OAuth 工具集,并说明自定义网关是信任边界;然而密钥处理细节、依赖审计证据和安装副作用恢复方法较少。安装示例包含远程脚本管道执行以及 npm 下载发布二进制,来源和外部影响可见但缺少校验步骤。仓库署名可见,但发布者身份未验证,且没有清晰的维护责任人或更新承诺。
README、入门文档和集成技能对项目绑定、scope、本地与 hosted MCP 的界限基本一致;文档还给出 doctor、status 和 findings 等诊断命令。样本没有依赖锁定与供应链审查细节,也没有展现 CLI 下载失败、网络故障等错误信息,因此依赖可用性和故障消息只能部分支持。
文档面向使用编码 Agent 的个人和团队,并覆盖多个 host、MCP-only、原生技能及本地/云路径。技能提供了按集成类型选择安装方式的边界,且提示用户范围只对明确支持的目标有效。触发条件和场景写得较清楚,项目级默认及 Windows、源码和打包安装路径也体现环境适配;但样本没有展示完整 host 支持矩阵或所有环境约束,不能给满分。
文档地图按任务组织,提供入门、支持矩阵、集成、基准、API/CLI 参考等入口,结构完整。安装说明涵盖多种方式和验证步骤,但远程安装示例缺少校验摘要或签名步骤。技能采用稳定名称和 frontmatter,也提供了可操作示例;样本中没有完整 FAQ。文档披露 hosted MCP 范围较窄、benchmark 结论有界等限制。LICENSE 明确为 Apache-2.0;版本与变更有 release 标记和自动 bump 工作流线索,但没有提供 CHANGELOG 内容;维护责任没有明确说明。
产品描述了从捕获策略、确定性验证、必要时人工审批到持久化证据和回归评估的工作流,并提供 CLI 命令及受限范围的 benchmark 数字,说明可能带来的治理价值。输出包括 findings、proof bundles、状态和 benchmark 比较,具有可用性;但样本未呈现实际输出格式或完整的成本/效益测量,相关主张仍有一部分停留在产品说明层面。
README 将 benchmark 主张限定到具名 suite、subject 和评分定义,并指向基准文档及复现协议;入门文档也给出运行与比较命令。产品说明与集成技能在本地和 hosted 能力边界上相互呼应,版本与安装信息亦有对应工作流线索。不过样本没有包含基准数据表、测试结果或实现代码来独立核对这些主张;文档对确定性扫描与模型评审证据作了明确区分,因此事实与推断有一定分隔但未完全验证。
- 安装路径会执行远程脚本或下载发布二进制;样本未展示校验摘要、签名验证或安装回滚步骤。使用前应核对所选发布物及其来源。
- 基准数字仅适用于文档声明的 suite、subject 和评分定义;本次静态样本不足以独立复核结果,也不能据此推断模型驱动的 Agent 效果。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
ControlKeel v0.4.21 Install - Homebrew: brew tap aryaminus/controlkeel && brew install controlkeel - npm bootstrap: npm i -g @aryaminus/controlkeel - Unix installer: curl -fsSL https://github.com/aryaminus/controlkeel/releases/latest/download/install.sh | sh - Raw GitHub shell installer: curl -fsSL https://raw.githubusercontent.com/aryaminus/controlkeel/main/scripts/install.sh | sh - PowerShell installer: irm https://github.com/aryaminus/controlkeel/releases/latest/download/install.ps1 | iex …在 GitHub 查看 ↗ -
发布说明摘录
ControlKeel v0.4.20 Install - Homebrew: brew tap aryaminus/controlkeel && brew install controlkeel - npm bootstrap: npm i -g @aryaminus/controlkeel - Unix installer: curl -fsSL https://github.com/aryaminus/controlkeel/releases/latest/download/install.sh | sh - Raw GitHub shell installer: curl -fsSL https://raw.githubusercontent.com/aryaminus/controlkeel/main/scripts/install.sh | sh - PowerShell installer: irm https://github.com/aryaminus/controlkeel/releases/latest/download/install.ps1 | iex …在 GitHub 查看 ↗ -
发布说明摘录
ControlKeel v0.4.19 Install - Homebrew: brew tap aryaminus/controlkeel && brew install controlkeel - npm bootstrap: npm i -g @aryaminus/controlkeel - Unix installer: curl -fsSL https://github.com/aryaminus/controlkeel/releases/latest/download/install.sh | sh - Raw GitHub shell installer: curl -fsSL https://raw.githubusercontent.com/aryaminus/controlkeel/main/scripts/install.sh | sh - PowerShell installer: irm https://github.com/aryaminus/controlkeel/releases/latest/download/install.ps1 | iex …在 GitHub 查看 ↗
常见问题
本地使用是否一定会产生模型调用费用?
它会在仓库外写入文件吗?
--scope user 仅适用于明确支持用户作用域的目标,并会写入用户配置,但不会把项目绑定或 proof 状态全局化。必须使用云服务吗?
接入失败时先检查什么?
controlkeel attach doctor、controlkeel provider doctor 和 controlkeel status。还应确认项目已被宿主信任,并在 attach 或插件变化后重启宿主。公开基准能否证明所有模型和宿主都同样有效?
ControlKeel 官网是什么?
ControlKeel 支持 Windows 吗?
irm https://github.com/aryaminus/controlkeel/releases/latest/download/install.ps1 | iex。ControlKeel 开源吗?
ControlKeel 安全吗?
ControlKeel 还在维护吗?
ControlKeel 是谁开发的?
谢谢反馈,我们会据此改进页面。