numbat

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

numbat स्थानीय हुक्स और प्लगइन्स, OTLP/HTTP लॉग्स, और डिस्क पर मौजूद सत्र आर्टिफैक्ट्स के माध्यम से समर्थित डेस्कटॉप, CLI, IDE, और गेटवे एजेंट्स का अवलोकन करता है। लाइव और विश्राम-अवस्था (at-rest) गतिविधि को एक इवेंट मॉडल में सामान्यीकृत किया जाता है और उसी 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.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 डिफ़ॉल्ट रूप से findings उत्सर्जित करता है। events और indicators को शामिल करने के लिए numbat scan --emit all का उपयोग करें। preview, full, और raw आउटपुट मोड के लिए content capture देखें।

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

live-capture support वाले किसी भी agent के लिए लाइव मॉनिटरिंग इंस्टॉल करें; नीचे दिए गए कमांड एक ठोस उदाहरण के रूप में Codex का उपयोग करते हैं। Hooks monitor-only मोड में शुरू होते हैं। --emit all events, findings, indicators, और लागू enforcement decisions को ~/.numbat/records.ndjson में लिखता है।

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

numbat को अपग्रेड करने के बाद, प्रत्येक इंस्टॉल किए गए एजेंट के लिए समान विकल्पों के साथ hook install फिर से चलाएँ। यह जनरेट किए गए hooks और plugins को अपडेट करता है; यदि उनकी परिभाषाएँ बदलती हैं तो होस्ट ट्रस्ट की फिर से समीक्षा करें।

Hook trust: आवश्यकताएँ एजेंट और स्कोप के अनुसार भिन्न होती हैं। ऊपर दिए गए Codex user hook के लिए, /hooks (CLI) या Settings > Hooks (app) में इसकी वर्तमान परिभाषा की समीक्षा करें और उसे ट्रस्ट करें, जिसमें --enforce जैसे परिवर्तनों के बाद भी शामिल है। --managed के साथ इंस्टॉल किए गए Codex hooks पॉलिसी द्वारा ट्रस्टेड होते हैं। hook status कॉन्फ़िगरेशन को सत्यापित करता है, न कि निष्पादन या डिलीवरी को। अन्य एजेंट और स्कोप के लिए deployment guide देखें।

सभी शिप किए गए नियम केवल-मॉनिटर हैं। किसी डिटेक्शन को लागू करने के लिए, उसकी पूरी shipped YAML को एक नियंत्रित ऑपरेटर डायरेक्टरी में कॉपी करें, वही id रखें, enforce: true जोड़ें, और उसका संस्करण बढ़ाएँ। किसी समर्थित pre-action hook के लिए उस प्रभावी पॉलिसी को मान्य और इंस्टॉल करें:

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