⚠️ This is an auto-generated translation. For the latest version, see the English README. Community corrections welcome!
🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français | 🇷🇺 Русский | 🇮🇳 हिन्दी | 🇹🇷 Türkçe | 🇻🇳 Tiếng Việt | 🇮🇹 Italiano | 🇸🇦 العربية | 🇮🇱 עברית
Traducciones: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית
Resolución de fallos en tiempo de ejecución para agentes de código. Se integra con Claude Code y Codex. Detecta bucles, acciones peligrosas y filtraciones de secretos antes de que se conviertan en incidentes. Sin latencia. Funciona localmente.
Instala hooks para uno o cualquier combinación:
failproofai policies --install --cli opencode pi gemini(o--cli claude codex copilot cursor opencode pi gemini). Omite--clipara detectar automáticamente los CLIs instalados y que te solicite confirmación.
npm install -g failproofai
failproofai policies --install # o simplemente ejecuta `failproofai` y acepta el aviso de primera ejecución
failproofai30 políticas integradas se activan de inmediato. Panel en localhost:8020. Desactiva el aviso de primera ejecución con FAILPROOFAI_NO_FIRST_RUN=1.
| Política | Qué bloquea |
|---|---|
block-push-master |
Pushes directos a main / master |
block-force-push |
git push --force |
block-work-on-main |
Commits, merges y rebases en main / master |
block-rm-rf |
Eliminación recursiva de archivos |
sanitize-api-keys |
Claves de API que se filtran al contexto del agente |
Coloca un archivo en .failproofai/policies/ — se carga automáticamente, sin necesidad de flags.
Confírmalo en el repositorio y todo el equipo lo obtiene en el siguiente pull.
import { customPolicies, deny, allow } from "failproofai";
customPolicies.add({
name: "no-production-writes",
match: { events: ["PreToolUse"] },
fn: async (ctx) => {
if (ctx.toolInput?.file_path?.includes("production"))
return deny("Writes to production paths are blocked.");
return allow();
},
});Tres decisiones disponibles para cada política:
| Decisión | Efecto |
|---|---|
allow() |
Permite la operación |
deny(message) |
La bloquea — el mensaje se devuelve al agente |
instruct(message) |
La deja pasar, pero añade contexto al siguiente prompt del agente |
→ Guía de políticas personalizadas
Cada llamada a herramienta que realiza tu agente se registra localmente. El panel muestra qué se ejecutó, qué fue bloqueado y qué le indicó la política al agente — así no tienes que adivinar cuando algo sale mal. → Guía del panel
| Primeros pasos | Instalación y primeros pasos |
| Políticas integradas | Las 30 políticas con sus parámetros |
| Políticas personalizadas | Escribe las tuyas propias |
| Configuración | Ámbitos de configuración y reglas de fusión |
| Panel | Monitor de sesión y actividad de políticas |
| Arquitectura | Cómo funciona el sistema de hooks |
MIT con Commons Clause — gratuita para uso interno y personal; la reventa comercial de failproofai en sí requiere un acuerdo separado. Consulta LICENSE para el texto completo.
Consulta CONTRIBUTING.md. Se aceptan nuevas políticas, casos límite y traducciones.
Compila antes de empezar. Ejecuta primero
bun install && bun run build. Este repositorio ejecuta los propios hooks de failproofai sobre sí mismo, y resuelven la importación defailproofaicontra el bundle compilado endist/— sin una compilación obtendrás errores de hookCannot find package 'failproofai'. Vuelve a compilar después de modificarsrc/. Consulta Build before the in-repo dev hooks will work.
Desarrollado por Nivedit Jain y Nikita Agarwal. befailproof.ai