failproofai

给AI编码代理装安全气囊，防死循环防泄密

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 574 🐛 待处理 62 👀 关注 4

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 8241

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队FailproofAI

官网地址https://befailproof.ai

GitHubhttps://github.com/FailproofAI/failproofai

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议NOASSERTION

主要语言TypeScript

技术栈/模型agent-failure,agent-harness,agent-observability,agent-reliability,agent-tracing,ai-agent,claude-code,codex,enforcement,evals,guardrails,hermes,hooks,llm,llm-failures,llm-observability,npm-package,observability,openclaw,reliability

GitHub 星标★ 8241

上线时间2026-04-06 00:00:00

代码更新2026-11-07

仓库体积96.9 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数4

项目介绍

failproofai 是一个面向 AI 编码代理的运行时故障解决方案库，通过钩子（hooks）机制集成到 Claude Code、Codex、Cursor 等主流编码代理工具中。它能在代理执行过程中实时监控，捕捉死循环、危险操作（如删除文件、执行高风险命令）和密钥泄露等潜在问题，在它们变成事故之前进行拦截和告警。项目以零延迟、本地运行为设计目标，不依赖云端服务，保障数据隐私。它解决了 AI 编码代理在自主执行时缺乏安全护栏、容易陷入无限循环或误操作的问题，为开发者提供了一层轻量级的安全保障。核心能力包括：事件钩子拦截、策略规则配置、实时告警与干预，以及跨多个代理框架的兼容性。当前项目处于早期阶段，但已获得一定关注。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 8241

技术标签

agent-harness agent-observability ai-agent claude-code codex

使用教程

难度：入门约 10 分钟部署方式：命令行工具 4 步

环境要求

已安装 npm（Node.js 环境，可执行全局安装）
终端可访问 npm 全局包目录（必要时用 sudo 或管理员权限）
本地可访问 localhost:8020 端口用于打开仪表盘

安装与启动步骤

1全局安装 CLI

用 npm 全局安装 failproofai 命令行工具，安装完成后即可在终端直接调用 failproofai 命令。
```
npm install -g failproofai
```
2安装内置策略

执行策略安装命令，一次性启用 39 条内置策略规则；也可以跳过此步，直接运行 failproofai 并在首次运行提示中确认。
```
failproofai policies --install
```
3启动 failproofai

运行主命令启动本地服务，开始对已接入的编码代理进行实时监控与拦截；如需免交互可先设置环境变量。
```
failproofai
```
4打开仪表盘

服务启动后在本机浏览器访问仪表盘，查看代理运行记录与被拦截的危险工具调用。

关键配置

配置项	必填	说明	示例
`FAILPROOFAI_NO_FIRST_RUN`	否	设为 1 可关闭首次运行提示，适合脚本化或自动化环境	`FAILPROOFAI_NO_FIRST_RUN=1`
`仪表盘端口`	否	本地仪表盘默认监听端口，服务启动后访问该地址	`localhost:8020`

如何确认成功

执行 failproofai 后进程正常驻留，浏览器打开 localhost:8020 能看到仪表盘，即表示启动成功。

常见问题

Q：每次启动都弹出首次运行提示，怎么关掉？

A：设置环境变量 FAILPROOFAI_NO_FIRST_RUN=1 后再次运行 failproofai，即可跳过首次运行提示。

Q：不想手动装策略可以吗？

A：可以。直接运行 failproofai，在首次运行提示中接受安装，效果等同于执行 failproofai policies --install。

Q：仪表盘在哪里看？

A：服务启动后，在浏览器访问 localhost:8020 即可打开本地仪表盘。

Q：需要联网或上传数据到云端吗？

A：不需要，failproofai 以本地运行、零延迟为设计目标，不依赖云端服务。

注意事项

项目当前处于早期开发阶段，接口与行为可能变化。
README 提到可钩住 12 种代理 harness，包括 Claude Code、Codex、Hermes、OpenClaw 等，覆盖编码 CLI 与聊天/助手网关两类。
内置 39 条策略，安装后立即生效。
仪表盘默认地址为 localhost:8020，仅本机可访问。