README.es.md

⚠️ 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 fugas de secretos antes de que se conviertan en incidentes. Latencia cero. Se ejecuta localmente.

---

CLIs de agentes compatibles

                    

             

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 --cli para detectar automáticamente los CLIs instalados y mostrar el asistente de configuración.

---

Instalación

npm install -g failproofai
failproofai policies --install   # o simplemente ejecuta `failproofai` y acepta el aviso del primer uso
failproofai

Se activan inmediatamente 30 políticas integradas. Panel de control en localhost:8020. Desactiva el aviso del primer uso con FAILPROOFAI_NO_FIRST_RUN=1.

---

Qué detiene

Política	Qué bloquea
block-push-master	Envíos 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

→ Las 30 políticas integradas

---

Tus propias políticas

Coloca un archivo en .failproofai/policies/ — se carga automáticamente, sin flags adicionales. Confírmalo en el repositorio y todo el equipo lo obtendrá en el próximo 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

---

Visibilidad de la sesión

Cada llamada a herramientas que realiza tu agente se registra localmente. El panel de control muestra qué se ejecutó, qué fue bloqueado y qué le indicó la política al agente — para que no tengas que adivinar cuando algo sale mal. → Guía del panel de control

---

Documentación

Primeros pasos	Instalación y pasos iniciales
Políticas integradas	Las 30 políticas con sus parámetros
Políticas personalizadas	Escribe las tuyas propias
Configuración	Alcances de configuración y reglas de fusión
Panel de control	Monitor de sesión y actividad de políticas
Arquitectura	Cómo funciona el sistema de hooks

---

Licencia

MIT con Commons Clause — gratuito para uso interno y personal; la reventa comercial de failproofai en sí requiere un acuerdo aparte. Consulta LICENSE para el texto completo.

---

Contribuciones

Consulta CONTRIBUTING.md. Son bienvenidas nuevas políticas, casos límite y traducciones.

---

Desarrollado por Nivedit Jain y Nikita Agarwal. befailproof.ai