numbat

Видимость активности AI-агентов на конечных точках с локальным обнаружением, опциональной блокировкой перед действием и форензической реконструкцией.

numbat наблюдает за поддерживаемыми десктопными, CLI-, IDE- и шлюзовыми агентами через локальные хуки и плагины, логи OTLP/HTTP и артефакты сессий на диске. Активность в реальном времени и в состоянии покоя нормализуется в единую модель событий и оценивается одним и тем же движком правил CEL. Обнаружение выполняется локально; записи могут выводиться в stdout или локальный файл и опционально доставляться по HTTP.

Матрица покрытия является авторитетным источником для каждого хоста и поверхности. Блокировка по умолчанию отключена и ограничена поддерживаемыми синхронными хуками перед действием; см. руководство по принудительному применению.

Возможности

• Мониторинг в реальном времени через хуки, плагины и экспортёры логов OTLP/HTTP.
• Локальное обнаружение на конечной точке со встроенными правилами CEL, многошаговыми последовательностными правилами и пользовательскими правилами YAML.
• Опциональная блокировка через поддерживаемые хуки перед действием. Режим принудительного применения отключён по умолчанию и применяется только к правилам с enforce: true; все поставляемые правила работают только в режиме мониторинга.
• Форензическая реконструкция из поддерживаемых артефактов сессий на диске без предварительной инструментации numbat.
• Версионированные записи NDJSON для событий, находок, решений о принудительном применении, индикаторов и сводок сканирования. События и находки сохраняют ссылки на источники; JSON-схемы определяют формат передачи.
• Сканирование артефактов только для чтения с редактированием секретов. Обычный вывод записей никогда не включает полный необработанный транскрипт; добавление файлов с необработанными доказательствами в пакет дела выполняется опционально.
• Инструменты инвентаризации и расследования для обнаружения агентов только для чтения, временных шкал по сессиям и переносимых пакетов дел с манифестами SHA-256.
• Распространение в виде одного бинарного файла для macOS, Linux и Windows, собранного без cgo.

Быстрый старт

Установка

Скачайте релиз для macOS, Linux или Windows на amd64 или arm64. Каждый релиз включает контрольные суммы SHA-256. Вы также можете установить с помощью Go 1.26.10 или новее:

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

CGO_ENABLED=0 go build -trimpath -o numbat ./cmd/numbat

$env:CGO_ENABLED = "0"
go build -trimpath -o numbat.exe ./cmd/numbat

Инвентаризация и сканирование

Эти команды только для чтения не устанавливают хуки и не изменяют конфигурацию агента:

numbat agents
# scan all discovered parser-backed agents
numbat scan
# or limit automatic discovery to Codex
numbat scan --agent codex

scan по умолчанию выводит находки. Используйте numbat scan --emit all, чтобы включить события и индикаторы. См. content capture для режимов вывода preview, full и raw.

Мониторинг и принудительное применение

Установите живой мониторинг для любого агента с поддержкой live-capture; в приведённых ниже командах Codex используется как конкретный пример. Хуки запускаются в режиме только мониторинга. --emit all записывает события, находки, индикаторы и применимые решения о принудительном применении в ~/.numbat/records.ndjson.

numbat hook install --agent codex --emit all
numbat hook status --agent codex

После обновления numbat повторно запустите hook install для каждого установленного агента с теми же параметрами. Это обновит сгенерированные хуки и плагины; если их определения изменятся, проверьте доверие на стороне хоста ещё раз.

Доверие к хукам: Требования различаются в зависимости от агента и области действия. Для пользовательского хука Codex, приведённого выше, проверьте и подтвердите его текущее определение в /hooks (CLI) или Settings > Hooks (приложение), в том числе после таких изменений, как --enforce. Хуки Codex, установленные с --managed, считаются доверенными согласно политике. hook status проверяет конфигурацию, а не выполнение или доставку. См. руководство по развёртыванию для других агентов и областей действия.

Все поставляемые правила работают только в режиме мониторинга. Чтобы включить принудительное применение обнаружения, скопируйте его полный поставляемый YAML в контролируемый каталог оператора, сохраните тот же id, добавьте enforce: true и увеличьте версию. Проверьте и установите эту действующую политику для поддерживаемого хука предварительного действия:

numbat rules check --rules-dir ./numbat-policy
numbat hook install --agent codex --emit all \
  --rules-dir ./numbat-policy --enforce

Пример вывода

{
  "actor": "assistant",
  "confidence": "medium",
  "content_preview": "http://169.254.169.254/latest/meta-data/iam/security-credentials/",
  "endpoint": {
    "hostname": "developer-workstation", "os": "linux", "arch": "arm64",
    "username": "node", "uid": "1000"
  },
  "event_id": "hook-run-20260724T151125.690671167-fa0a4148090fa1ba",
  "event_type": "network.indicator",
  "evidence": {"artifact_type": "hook"},
  "project_path": "/workspace/acme-api",
  "record_type": "event",
  "run_id": "run-20260724T151125.690671167-fa0a4148090fa1ba",
  "schema_version": "0.5.0",
  "session_id": "agent:research:metadata-review",
  "source_agent": "openclaw",
  "source_type": "hook",
  "sub_agent": "research",
  "tags": ["network"],
  "timestamp": "2026-07-24T15:20:00Z",
  "tool_call_id": "tool-cloud-metadata-01",
  "tool_name": "browser",
  "url": "http://169.254.169.254/latest/meta-data/iam/security-credentials/"
}