Failproof AI
为编码代理在本地拦截危险操作、循环与密钥泄漏。
- Star 数
- ★ 8.1k
- 最近更新
- 3 天前
- License
- NOASSERTION
- 主语言
- TypeScript
- FA 评分
- 40/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Claude Code 或 Codex 管理生产仓库的开发者，希望在代理尝试直接推送 main/master 前自动拦截。
- 不适合
- 需要托管式云端可观测性的团队，除非购买企业版自托管
- 只使用未列入十二种受支持 harness 的自研 agent 运行时的团队
- 无法使用 npm、shell 和本地文件系统的纯浏览器或托管环境
这个 Agent 能做什么，适合哪些场景？
Failproof AI 是面向编码代理 CLI 的本地运行时策略工具，通过钩子处理代理的工具调用。它明确支持 Claude Code、OpenAI Codex、GitHub Copilot CLI、Cursor Agent CLI、OpenCode、Pi 等命令行代理。安装后会立即启用 30 条内置策略，并在 localhost:8020 提供本地仪表盘。策略可阻止直接推送到 main/master、强制推送、在主分支提交或变基、递归删除文件，以及 API 密钥进入代理上下文。团队也可以将 JavaScript 自定义策略放入 .failproofai/policies/ 并提交到仓库，以便其他成员拉取后加载。
运行 failproofai 后，它接入受支持代理 CLI 的钩子并处理工具调用。内置策略检查诸如 git push --force、直接推送 main/master、在 main/master 上提交/合并/变基、递归删除以及 API 密钥暴露到代理上下文等行为；策略可返回 allow()、deny(message) 或 instruct(message)。自定义策略使用 customPolicies.add() 注册，可匹配 PreToolUse 等事件，并从 ctx.toolInput 读取工具输入，例如检查 file_path。每次代理工具调用都会被本地记录，仪表盘展示执行内容、被拦截的操作和返回给代理的策略信息。
- 使用 Claude Code 或 Codex 管理生产仓库的开发者，希望在代理尝试直接推送 main/master 前自动拦截。
- 允许编码代理执行 Git 操作的团队，需要禁止
git push --force及在主分支上提交、合并或变基。 - 让代理处理代码库清理任务的工程师，需要在递归删除文件发生前进行策略拦截。
- 担心凭据被带入代理上下文的团队，希望启用
sanitize-api-keys策略。 - 需要限制 production 路径写入的仓库维护者，可在
.failproofai/policies/中提交no-production-writes自定义策略。
如何安装或部署这个 Agent？
无需文档中说明的凭据。使用 npm 全局安装并安装策略：
npm install -g failproofai
failproofai policies --install然后运行：
failproofai首次运行会出现提示；如需关闭，设置 FAILPROOFAI_NO_FIRST_RUN=1。
如何使用这个 Agent？
完成安装后运行 failproofai，30 条内置策略会立即启用。打开 localhost:8020 查看本地会话和策略活动。要加入团队策略，在仓库创建 .failproofai/policies/ 下的 JavaScript 文件，使用 customPolicies.add({ name, match: { events: ["PreToolUse"] }, fn }) 注册；fn 返回 allow()、deny(message) 或 instruct(message)。提交该文件后，团队成员下次拉取时可加载它。
这个 Agent 有哪些优点和局限？
- 在代理工具调用阶段执行策略，可直接阻止危险 Git 操作和递归删除，而非只在事后审计。
- 内置 30 条策略，并明确覆盖主分支保护、强制推送和 API 密钥上下文泄漏等常见风险。
- 支持以 JavaScript 编写仓库级自定义策略，放入
.failproofai/policies/即可自动加载。 - 所有工具调用均记录在本地，localhost:8020 仪表盘可查看执行、拦截与策略反馈。
- 明确支持的是特定代理 CLI；未提供通用 API 协议或任意代理运行时的接入说明。
- 安装和运行依赖 shell、npm 以及本地文件系统访问，不是托管式 Web 服务。
- 商业转售 Failproof AI 本身需要另行协议；许可证为 MIT 加 Commons Clause。
- README 对内置策略完整行为、误报处理和性能测量的细节仅链接到外部文档，所给材料未展开说明。
这个 Agent 与同类方案有什么区别？
它不是 Claude Code 或 Codex 的替代品，而是通过钩子为这些编码代理及其他受支持 CLI 增加运行时策略层；仓库还列出 GitHub Copilot CLI、Cursor Agent CLI、OpenCode、Pi、Hermes、OpenClaw、Factory Droid、Devin CLI、Antigravity CLI 和 Goose。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Failproof AI 当前 | 40 · 缺口较多 | 命令行工具免费版 + 付费版 | ★ 8.1k | 3 天前 | TypeScript | Codex · Claude Code |
| Octogent | 59 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.4k | 6 个月前 | TypeScript | Claude Code |
| OrchestKit AI 开发工具箱 | 86 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 299 | 今天 | TypeScript | Claude Code |
| CC Safety Net —— AI 编码代理的安全网 | 63 · 存在缺口 | 命令行工具免费 | ★ 1.9k | 1 天前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示有策略机制（如deny/allow）和本地运行，但未明确最小权限原则；用户确认仅提及首次运行提示，未覆盖所有危险操作；数据流透明度有本地日志和仪表盘，但未说明数据流向；敏感数据处理有sanitize-api-keys策略，但未说明存储和加密；依赖安全有OSV-Scanner和Socket，但未提供扫描结果；外部影响有阻止危险git操作，但未说明网络访问；回滚机制未提及；来源归属有作者信息，但发布者未验证。
自一致性：README声称零延迟，但未提供性能数据；依赖可用性：有CI和构建流程，但未提供依赖可用性保证；失败消息：有deny消息返回给agent，但未说明错误处理。
受众和场景：面向开发者和多种agent CLI，场景明确；能力边界：有30个内置策略，但未说明自定义策略的限制；触发精度：有事件匹配，但未说明误报率；环境适配：支持多种CLI和本地运行，但未说明系统要求。
信息架构：有文档链接和目录，结构清晰；安装说明：有npm安装命令，但未提供详细步骤；命名稳定性：版本为beta，可能不稳定；示例和FAQ：有自定义策略示例，但无FAQ；已知限制：未明确列出；许可证：MIT+Commons Clause，但元数据为NOASSERTION；版本和变更日志：有版本号，但无变更日志；维护责任：有作者和联系方式，但未说明维护计划。
输出可用性：有仪表盘和日志，但未说明输出格式；边际价值：提供失败预防功能，有独特价值；成本效益：本地运行，但未提供性能数据。
声明可追溯：README有文档链接，但未提供具体证据；跨来源验证：有CI和扫描，但未提供结果；事实与推断分离：未明确区分。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 发布者未验证，身份未知。
- 许可证元数据为NOASSERTION，实际为MIT+Commons Clause，需确认合规性。
- 版本为beta，可能不稳定。
- 未提供回滚机制。
- 未提供性能数据，零延迟声明未验证。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v1.0.13 FailproofAI v1.0.13
发布说明摘录
failproofai 1.0.13 This release restores policy enforcement on OpenClaw 2026.9.6+ and on Antigravity's current file tools, and makes daemon setup work on Fedora, RHEL, Rocky and Alma. Fixes Antigravity - Path policies enforce again. Antigravity's read_file, write_file and edit_file tools were not recognized, so path-based policies and the guard protecting failproofai's own config saw no path and allowed the call. An agent could read and overwrite .env, create id_rsa, and overwrite .failproofai/policies-config.json. These calls are now denied. (#961) …在 GitHub 查看 ↗ -
fp-cloud-cli-v0.0.2 fp-cloud-cli 0.0.2
发布说明摘录
fp-cloud-cli 0.0.2 is on PyPI: https://pypi.org/project/fp-cloud-cli/0.0.2/ --- Stable release. The 0.0.2b0 line the bump job opened after 0.0.1 is cut stable here rather than published, because the server endpoints these commands drive are now deployed to FailproofAI Cloud and the CLI should not trail them as a pre-release. Nothing about the command surface changes at the cut: the entries below are the entire diff from 0.0.1, and the bump job opens 0.0.3b0 after the upload. Added …在 GitHub 查看 ↗ -
v1.0.12 FailproofAI 1.0.12
常见问题
它会替代我的编码代理吗？
策略能做什么决定？
allow() 放行、deny(message) 阻止并向代理返回消息，或使用 instruct(message) 放行并为代理下一次提示补充上下文。是否需要把日志上传到外部服务？
localhost:8020；未说明必须上传日志。团队如何共享自定义限制？
.failproofai/policies/ 并提交；材料说明其他成员下次拉取后会获得该策略。