numbat

Endpunkt-Sichtbarkeit in die Aktivität von KI-Agenten, mit lokaler Erkennung, optionaler Blockierung vor Aktionen und forensischer Rekonstruktion.

numbat beobachtet unterstützte Desktop-, CLI-, IDE- und Gateway-Agenten über lokale Hooks und Plugins, OTLP/HTTP-Logs und Session-Artefakte auf der Festplatte. Live- und At-Rest-Aktivität wird in ein einheitliches Ereignismodell normalisiert und von derselben CEL-Regel-Engine ausgewertet. Die Erkennung läuft lokal; Datensätze können nach stdout oder in eine lokale Datei geschrieben und optional über HTTP übermittelt werden.

Die Abdeckungsmatrix ist maßgeblich für jeden Host und jede Oberfläche. Die Blockierung ist standardmäßig deaktiviert und auf unterstützte synchrone Pre-Action-Hooks beschränkt; siehe die Durchsetzungsanleitung.

Funktionen

• Live-Überwachung über Hooks, Plugins und OTLP/HTTP-Log-Exporter.
• Endpunktlokale Erkennung mit integrierten CEL-Regeln, mehrstufigen Sequenzregeln und benutzerdefinierten YAML-Regeln.
• Opt-in-Blockierung über unterstützte Pre-Action-Hooks. Der Enforce-Modus ist standardmäßig deaktiviert und gilt nur für Regeln, die mit enforce: true markiert sind; alle mitgelieferten Regeln sind reine Überwachungsregeln.
• Forensische Rekonstruktion aus unterstützten Session-Artefakten auf der Festplatte, ohne vorherige numbat-Instrumentierung.
• Versionierte NDJSON-Datensätze für Ereignisse, Findings, Durchsetzungsentscheidungen, Indikatoren und Scan-Zusammenfassungen. Ereignisse und Findings behalten Quellverweise bei; JSON-Schemas definieren das Wire-Format.
• Schreibgeschütztes Scannen von Artefakten mit Secret-Redaktion. Die normale Datensatzausgabe enthält niemals ein vollständiges Rohtranskript; das Hinzufügen von Rohbelegdateien zu einem Case- Bundle ist Opt-in.
• Inventar- und Untersuchungswerkzeuge für schreibgeschützte Agent-Erkennung, Sitzungs-Timelines und portable Case-Bundles mit SHA-256-Manifesten.
• Einzelbinär-Distribution für macOS, Linux und Windows, ohne cgo gebaut.

Schnellstart

Installation

Laden Sie ein Release herunter für macOS, Linux oder Windows auf amd64 oder arm64. Jedes Release enthält SHA-256-Prüfsummen. Sie können auch mit Go 1.26.10 oder neuer installieren:

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

Inventarisierung und Scan

Diese schreibgeschützten Befehle installieren keine Hooks und ändern keine Agent-Konfiguration:

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

scan gibt standardmäßig Findings aus. Verwenden Sie numbat scan --emit all, um Events und Indicators einzuschließen. Siehe content capture für die Ausgabemodi preview, full und raw.

Überwachen und durchsetzen

Installieren Sie Live-Monitoring für jeden Agent mit live-capture support; die folgenden Befehle verwenden Codex als konkretes Beispiel. Hooks starten im Monitor-only-Modus. --emit all schreibt Events, Findings, Indicators und zutreffende Enforcement-Entscheidungen nach ~/.numbat/records.ndjson.

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

Nach dem Upgrade von numbat führe hook install für jeden installierten Agenten mit denselben Optionen erneut aus. Dadurch werden generierte Hooks und Plugins aktualisiert; überprüfe das Vertrauen des Hosts erneut, wenn sich deren Definitionen ändern.

Hook-Vertrauen: Die Anforderungen variieren je nach Agent und Geltungsbereich. Überprüfe für den oben genannten Codex-Benutzer-Hook seine aktuelle Definition in /hooks (CLI) oder unter Einstellungen > Hooks (App) und vertraue ihr, auch nach Änderungen wie --enforce. Codex-Hooks, die mit --managed installiert wurden, sind per Richtlinie vertrauenswürdig. hook status überprüft die Konfiguration, nicht die Ausführung oder Zustellung. Siehe den Bereitstellungsleitfaden für andere Agenten und Geltungsbereiche.

Alle mitgelieferten Regeln sind nur zur Überwachung gedacht. Um eine Erkennung zu erzwingen, kopiere ihre vollständige mitgelieferte YAML in ein kontrolliertes Betreiberverzeichnis, behalte dieselbe ID bei, füge enforce: true hinzu und erhöhe ihre Version. Validiere und installiere diese effektive Richtlinie für einen unterstützten Pre-Action-Hook:

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

Beispielausgabe

{
  "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/"
}