Repolode
Enviar
perplexityai

perplexityai/numbat

Visibilidade sobre a atividade de agentes de IA, com detecção local, bloqueio opcional antes das ações e reconstrução forense a partir de artefatos de sessão.

Ver no GitHub
Estrelas
1,162
Forks
125
Issues abertas
14
Último commit
há 4 dias

O que é?

numbat observa agentes compatíveis de desktop, CLI, IDE e gateway por meio de hooks e plugins locais, exportadores de logs OTLP/HTTP e artefatos de sessão em disco. A atividade em tempo real e em repouso é normalizada em um único modelo de eventos e avaliada pelo mesmo mecanismo de regras CEL, com detecção executada localmente. Os registros podem ser gravados em stdout ou em um arquivo local e, opcionalmente, enviados por HTTP.

O bloqueio vem desativado por padrão e se aplica somente a hooks síncronos compatíveis executados antes da ação e a regras marcadas explicitamente para aplicação. Todas as regras fornecidas são apenas de monitoramento; portanto, os operadores precisam copiar uma regra, definir o sinalizador enforce e instalar essa política por conta própria. A reconstrução forense funciona com artefatos de sessão compatíveis, sem instrumentação prévia, e as varreduras somente leitura removem segredos da saída.

O projeto é distribuído como um único binário compilado sem cgo para macOS, Linux e Windows. Inclui inventário, linhas do tempo por sessão e pacotes de casos portáteis com manifestos SHA-256.

Recursos principais

  • 01Monitoramento em tempo real por meio de hooks, plugins e exportadores de logs OTLP/HTTP.
  • 02Detecção local com regras CEL integradas, regras de sequência com várias etapas e regras YAML personalizadas.
  • 03Bloqueio opcional em hooks compatíveis executados antes da ação, desativado por padrão.
  • 04Reconstrução forense a partir de artefatos de sessão compatíveis armazenados em disco.
  • 05Registros NDJSON versionados com JSON Schemas para o formato de transmissão.
  • 06Varredura de artefatos somente leitura com remoção de segredos.
  • 07Pacotes de casos portáteis com manifestos SHA-256.

Casos de uso

  • Monitorar o que agentes de programação leem, escrevem e executam nas estações de trabalho de desenvolvedores.
  • Investigar uma sessão de agente posteriormente, usando os artefatos armazenados em disco.
  • Bloquear um conjunto restrito de ações de alto risco, como gravações em SSH authorized_keys, após configurar deliberadamente uma política.
  • Compartilhar as evidências de um incidente como um pacote de caso verificável.

Início rápido

  1. 1

    Instale o numbat com Go 1.26.9 ou posterior

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

    Liste os agentes detectados e examine seus artefatos (somente leitura)

    numbat agents
  3. 3

    Instale hooks de monitoramento ao vivo para o Codex (somente monitoramento por padrão)

    numbat hook install --agent codex --emit all

Antes de usar

  • A cobertura do monitoramento ao vivo varia de acordo com o agente e a superfície; consulte a matriz de cobertura antes de confiar nele.
  • O bloqueio vem desativado por padrão e todas as regras incluídas são somente para monitoramento; para aplicar controles, é necessário criar e manter suas próprias regras.
  • Os hooks precisam passar por uma revisão de confiança no host após a instalação e após as atualizações, o que acrescenta etapas operacionais.

Em coleções

Frameworks e apps de agentes de IA open source

Tópicos

#agent-security#ai-agents#endpoint-security#threat-detection#audit-logging#forensics#cel#go#ai-agent-security

Perguntas frequentes

O que é numbat?
Visibilidade sobre a atividade de agentes de IA, com detecção local, bloqueio opcional antes das ações e reconstrução forense a partir de artefatos de sessão. numbat observa agentes compatíveis de desktop, CLI, IDE e gateway por meio de hooks e plugins locais, exportadores de logs OTLP/HTTP e artefatos de sessão em disco. A atividade em tempo real e em repouso é normalizada em um único modelo de eventos e avaliada pelo mesmo mecanismo de regras CEL, com detecção executada localmente. Os registros podem ser gravados em stdout ou em um arquivo local e, opcionalmente, enviados por HTTP.
numbat é gratuito? Qual é a licença?
numbat é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
numbat ainda é mantido?
Manutenção ativa. O último commit de numbat foi em 4 de nov. de 2026.
Para que posso usar numbat?
Monitorar o que agentes de programação leem, escrevem e executam nas estações de trabalho de desenvolvedores. Investigar uma sessão de agente posteriormente, usando os artefatos armazenados em disco. Bloquear um conjunto restrito de ações de alto risco, como gravações em SSH authorized_keys, após configurar deliberadamente uma política. Compartilhar as evidências de um incidente como um pacote de caso verificável.
Como instalar numbat?
Instale o numbat com Go 1.26.9 ou posterior: go install github.com/perplexityai/numbat/cmd/numbat@latest Liste os agentes detectados e examine seus artefatos (somente leitura): numbat agents Instale hooks de monitoramento ao vivo para o Codex (somente monitoramento por padrão): numbat hook install --agent codex --emit all
Onde consigo numbat?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/perplexityai/numbat

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados