Repolode
perplexityai

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. 1

    Instala numbat con Go 1.26.9 o posterior

    go install github.com/perplexityai/numbat/cmd/numbat@latest
  2. 2

    Enumera los agentes detectados y analiza sus artefactos (solo lectura)

    numbat agents
  3. 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

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.

985+11 esta semana114GoApache-2.0Bien mantenidoActualizado hace 19 horas