Gateway local-first escrito en Go que comprueba las llamadas a herramientas de agentes de programación con IA según políticas, detecta secretos y mantiene un registro de auditoría en el dispositivo.
perplexityai/numbat
Visibilidad de la actividad de agentes de IA en los endpoints, con detección local, bloqueo opcional antes de la acción y reconstrucción forense a partir de artefactos de sesión.
- Estrellas
- 1,162
- Forks
- 125
- Issues abiertos
- 14
- Último commit
- hace 3 días
¿Qué es?
numbat observa agentes compatibles de escritorio, CLI, IDE y gateway mediante hooks y plugins locales, exportadores de logs OTLP/HTTP y artefactos de sesión en disco. La actividad en tiempo real y en reposo se normaliza en un único modelo de eventos y se evalúa con el mismo motor de reglas CEL, mientras la detección se ejecuta localmente. Los registros se pueden escribir en stdout o en un archivo local y, de forma opcional, enviar por HTTP.
El bloqueo está desactivado de forma predeterminada y solo se aplica a hooks síncronos compatibles que se ejecutan antes de la acción y a reglas marcadas explícitamente para su aplicación. Todas las reglas incluidas son solo de monitorización, así que los operadores deben copiar una regla, activar su indicador enforce e instalar esa política por su cuenta. La reconstrucción forense funciona con artefactos de sesión compatibles sin instrumentación previa, y los análisis de solo lectura ocultan los secretos en la salida.
El proyecto se distribuye como un único binario compilado sin cgo para macOS, Linux y Windows. Incluye inventario, cronologías por sesión y paquetes de casos portátiles con manifiestos SHA-256.
Funciones clave
- 01Monitorización en tiempo real mediante hooks, plugins y exportadores de logs OTLP/HTTP.
- 02Detección local con reglas CEL integradas, reglas de secuencia de varios pasos y reglas YAML personalizadas.
- 03Bloqueo opcional en hooks compatibles previos a la acción, desactivado de forma predeterminada.
- 04Reconstrucción forense a partir de artefactos de sesión compatibles almacenados en disco.
- 05Registros NDJSON con versiones y JSON Schemas para el formato de intercambio.
- 06Análisis de artefactos de solo lectura con ocultación de secretos.
- 07Paquetes de casos portátiles con manifiestos SHA-256.
Casos de uso
- Monitorizar qué leen, escriben y ejecutan los agentes de programación en las estaciones de trabajo de los desarrolladores.
- Investigar una sesión de agente a posteriori a partir de sus artefactos en disco.
- Bloquear un conjunto acotado de acciones de alto riesgo, como escribir en SSH authorized_keys, una vez configurada deliberadamente una política.
- Compartir las pruebas de un incidente en un paquete de caso verificable.
Inicio rápido
- 1
Instala numbat con Go 1.26.9 o posterior
go install github.com/perplexityai/numbat/cmd/numbat@latest - 2
Enumera los agentes detectados y analiza sus artefactos (solo lectura)
numbat agents - 3
Instala hooks de monitorización en tiempo real para Codex (solo monitorización de forma predeterminada)
numbat hook install --agent codex --emit all
Antes de usarlo
- La cobertura de la monitorización en tiempo real varía según el agente y la superficie; consulta la matriz de cobertura antes de confiar en ella.
- El bloqueo está desactivado de forma predeterminada y todas las reglas incluidas son solo de monitorización; para aplicar controles, tendrás que crear y mantener tus propias reglas.
- Los hooks requieren una revisión de confianza en el host después de la instalación y de cada actualización, lo que añade pasos operativos.
En colecciones
Temas
Preguntas frecuentes
- ¿Qué es numbat?
- Visibilidad de la actividad de agentes de IA en los endpoints, con detección local, bloqueo opcional antes de la acción y reconstrucción forense a partir de artefactos de sesión. numbat observa agentes compatibles de escritorio, CLI, IDE y gateway mediante hooks y plugins locales, exportadores de logs OTLP/HTTP y artefactos de sesión en disco. La actividad en tiempo real y en reposo se normaliza en un único modelo de eventos y se evalúa con el mismo motor de reglas CEL, mientras la detección se ejecuta localmente. Los registros se pueden escribir en stdout o en un archivo local y, de forma opcional, enviar por HTTP.
- ¿numbat es gratuito? ¿Qué licencia tiene?
- numbat es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿numbat sigue mantenido?
- Mantenimiento activo. El último commit de numbat fue el 4 nov 2026.
- ¿Para qué puedo usar numbat?
- Monitorizar qué leen, escriben y ejecutan los agentes de programación en las estaciones de trabajo de los desarrolladores. Investigar una sesión de agente a posteriori a partir de sus artefactos en disco. Bloquear un conjunto acotado de acciones de alto riesgo, como escribir en SSH authorized_keys, una vez configurada deliberadamente una política. Compartir las pruebas de un incidente en un paquete de caso verificable.
- ¿Cómo se instala numbat?
- Instala numbat con Go 1.26.9 o posterior: go install github.com/perplexityai/numbat/cmd/numbat@latest Enumera los agentes detectados y analiza sus artefactos (solo lectura): numbat agents Instala hooks de monitorización en tiempo real para Codex (solo monitorización de forma predeterminada): numbat hook install --agent codex --emit all
- ¿Dónde consigo numbat?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/perplexityai/numbat
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Capa de seguridad local que revisa los comandos de shell, el acceso a archivos, las instalaciones de paquetes y las llamadas a herramientas MCP de los agentes de IA antes de ejecutarlos.
Firewall de código abierto para agentes de IA que se interpone entre los agentes y la red para bloquear la exfiltración de secretos, la inyección de prompts, SSRF y el envenenamiento de herramientas MCP, con recibos de acciones firmados.
Sistema de seguridad empresarial que descubre, supervisa, compara y detecta comportamientos riesgosos de agentes de programación con IA y agentes de soporte al cliente.
Plataforma de operaciones de seguridad autoalojada con licencia MIT, donde agentes de IA investigan detecciones y actúan según políticas, aprobaciones y mecanismos de reversión.
Escáner de seguridad para agentes de programación con IA que analiza el código generado, los servidores MCP, los prompts y los paquetes sugeridos por IA para detectar riesgos.