Repolode
LuD1161

LuD1161/agentjail

Guardrails de políticas para agentes de programación como Claude Code, Codex y Cursor: comprueba cada llamada a herramientas localmente antes de ejecutarla.

Estrellas
100
Forks
8
Issues abiertos
2
Último commit
el mes pasado

¿Qué es?

AgentJail es una capa de seguridad para agentes de programación como Claude Code, Codex y Cursor. Después de instalarlo, registra hooks en cada agente compatible para evaluar cada llamada a herramientas (comandos de shell, lectura y edición de archivos, llamadas a MCP) según las reglas de Open Policy Agent (OPA) Rego antes de ejecutarla. Las decisiones pueden ser permitir, preguntar o denegar, y un daemon local persistente con caché de decisiones agiliza las comprobaciones.

Los hooks por sí solos son comprobaciones cooperativas. Al iniciar un agente mediante `agentjail run`, se añade un sandbox a nivel del sistema operativo que restringe el acceso al sistema de archivos independientemente del daemon de hooks. Entre las funciones opcionales se incluyen una lista de permitidos para la red que deniega todo por defecto, un intermediario de credenciales que entrega a una sesión los secretos seleccionados explícitamente, una interfaz web local, la reproducción de decisiones en la terminal y el cálculo local de costos a partir de transcripciones de Claude Code, Codex y OpenCode. El proyecto es compatible con macOS y Linux, y está escrito en Go.

Funciones clave

  • 01Comprueba cada llamada a herramientas del agente según las políticas OPA Rego antes de ejecutarla
  • 02Devuelve decisiones de permitir, preguntar o denegar, con explicaciones
  • 03Añade un sandbox a nivel del sistema operativo para restringir el sistema de archivos mediante `agentjail run`
  • 04Lista de permitidos para la red que deniega todo por defecto, con visibilidad opcional del tráfico
  • 05Intermediario de credenciales que entrega a una sesión únicamente los secretos seleccionados explícitamente
  • 06Visor local de reproducciones, panel para la terminal e informes de costos

Casos de uso

  • Impedir que un agente de programación ejecute comandos destructivos, como force-pushes o eliminaciones recursivas
  • Evitar que archivos .env o credenciales de la nube se filtren accidentalmente al contexto de un agente
  • Limitar los hosts a los que un agente puede enviar datos durante una sesión
  • Revisar qué hizo un agente y por qué mediante la reproducción de sesiones

Inicio rápido

  1. 1

    Instala primero minisign (macOS)

    brew install minisign
  2. 2

    Instala AgentJail con Homebrew

    brew install LuD1161/tap/agentjail
  3. 3

    Comprueba el estado de protección

    agentjail doctor
  4. 4

    Inicia tu agente a través de AgentJail con el sandbox del sistema operativo

    agentjail run -- codex

Antes de usarlo

  • Solo es compatible con macOS y Linux.
  • Los hooks por sí solos son comprobaciones cooperativas, no un límite de aislamiento del sistema de archivos; para usar el sandbox del sistema operativo, hay que iniciar el agente con agentjail run.
  • Algunas protecciones dependen de que el daemon esté disponible y del nivel de cobertura del sandbox en cada plataforma.

En colecciones

Temas

Preguntas frecuentes

¿Qué es agentjail?
Guardrails de políticas para agentes de programación como Claude Code, Codex y Cursor: comprueba cada llamada a herramientas localmente antes de ejecutarla. AgentJail es una capa de seguridad para agentes de programación como Claude Code, Codex y Cursor. Después de instalarlo, registra hooks en cada agente compatible para evaluar cada llamada a herramientas (comandos de shell, lectura y edición de archivos, llamadas a MCP) según las reglas de Open Policy Agent (OPA) Rego antes de ejecutarla. Las decisiones pueden ser permitir, preguntar o denegar, y un daemon local persistente con caché de decisiones agiliza las comprobaciones.
¿agentjail es gratuito? ¿Qué licencia tiene?
agentjail es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿agentjail sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de agentjail fue el 24 sept 2026.
¿Para qué puedo usar agentjail?
Impedir que un agente de programación ejecute comandos destructivos, como force-pushes o eliminaciones recursivas Evitar que archivos .env o credenciales de la nube se filtren accidentalmente al contexto de un agente Limitar los hosts a los que un agente puede enviar datos durante una sesión Revisar qué hizo un agente y por qué mediante la reproducción de sesiones
¿Cómo se instala agentjail?
Instala primero minisign (macOS): brew install minisign Instala AgentJail con Homebrew: brew install LuD1161/tap/agentjail Comprueba el estado de protección: agentjail doctor Inicia tu agente a través de AgentJail con el sandbox del sistema operativo: agentjail run -- codex
¿Dónde consigo agentjail?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/LuD1161/agentjail

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados