Vigil

يشغّل Vigil مهام أمن هجومي طويلة الأمد: اختبار اختراق تطبيقات الويب وصيد مكافآت الثغرات، أو تدقيق الشيفرة بالصندوق الأبيض، أو كليهما ضد هدف واحد. يحافظ مشغّل خفيف على مسار المهمة بينما يقوم وكلاء متخصصون بالاستطلاع والصيد والاستغلال داخل بيئة Kali كاملة. لا تُحتسب النتيجة إلا عندما يؤكدها وكيل ثانٍ مقابل أدلة مُلتقطة، وتُظهر سلاسل الهجوم تأثيرها الحقيقي. كل أمر وطلب وفحص ونتيجة يُسجَّل في قاعدة بيانات دائمة، فيبقى العمل صامدًا أمام حدود السياق وإعادة التشغيل وقابلًا للتدقيق لاحقًا.

للاستخدام المصرَّح به فقط. يقود Vigil أدوات هجومية بشكل ذاتي ضد أنظمة حيّة. استخدمه فقط بتصريح صريح ونطاق مُراجَع. يُقدَّم دون ضمان بموجب Apache License 2.0؛ أنت مسؤول عن الأوامر وبيانات الاعتماد والبنية التحتية وتأثيرات الهدف. راجع SECURITY.md للإبلاغ الخاص عن الثغرات وحدود بيانات المشغّل.

ما الذي يوفره Vigil

• مهام طويلة الأمد. تعيش الحالة في الواجهة الخلفية، فتصمد المهمة أمام الضغط وإعادة التشغيل والجلسات الجديدة.
• نتائج مُتحقَّق منها بشكل مستقل. لا يمكن إلا لإرسالية غير إرسالية المؤلف أن تؤكد النتيجة أو تخفّضها أو تصنّفها كإيجابية كاذبة، ويجب أن تستشهد بإيصال إثبات للأدلة المُلتقطة.
• التأثير. تربط سلاسل الهجوم النتائج في استغلال شامل من البداية إلى النهاية؛ وبشكل افتراضي، ينتظر عمل الاستغلال موافقتك.
• سجل تدقيق. تُنفَّذ الأوامر الموجَّهة نحو الهدف عبر vigil assess kali، الذي يسجّل argv لكل أمر، والوكيل، والمرحلة، والتقنية، والنية، ونوع الفحص، وحالة الخروج، والمخرجات. تُظهر سجلات التغطية ما تم اختباره وما لم يتم.
• أدوات الهجوم. حاوية Kali طويلة العمر مع استطلاع ProjectDiscovery، وأدوات التشويش، ومتصفح Playwright مُدقَّق، والتقاط MITM بهويات متعددة لاختبار الحسابات المتقاطعة، واستدعاءات خارج النطاق مرتبطة بالفحص الذي تسبّب فيها.
• تدقيق الشيفرة بالصندوق الأبيض. لقطة مصدرية مختومة ومعنونة بالمحتوى مع فهرس هيكلي tree-sitter وسجل تغطية.
• مخرجات جاهزة للتقديم. تُصدَّر النتائج كتقارير Bugcrowd أو HackerOne أو إفصاح مباشر مُتحقَّق منها بالتجزئة.
• العملاء. يحظى Claude Code وCodex بدعم كامل: إرسالية متخصصة بلا واجهة، وأوامر جلسة vigil-*، وخطافات الضغط والجلسة. يفتقر goose وopencode وKimi إلى أوامر الجلسة وخطافات الضغط، ويشغّل opencode وKimi المتخصصين بشكل مضمَّن. يدعم Pi مهام المعالجة فقط.

كيف يصطاد Vigil

• لا ثغرات مُسمّاة مسبقًا. الإفراط في التلقين يحدّ مما يجده النموذج. تحمل الإرساليات السطح والنطاق وقواعد الاشتباك، وليس الثغرة المطلوب البحث عنها أو قائمة تحقق. يختار متخصصو الويب ما يفحصونه ضمن ذلك السطح؛ ويحصل صائدو الشيفرة على دفعة ملفات وفئات الثغرات لتقييمها.
• عدسة واحدة لكل صيد. تحدّد كل إرسالية صيد مدى الاتساع، وكيفية العمل عبر مدخلاتها، وعدسة عقلية واحدة على الأكثر: مطوّر، أو حقن، أو تحكم بالوصول، أو منطق أعمال، أو تأثير السلسلة، أو مدقّق متشكك.
• تحقق مستقل. لا تُؤكَّد النتيجة إلا بوكيل مختلف يعمل من أدلة مُلتقطة. تضيف مهام الشيفرة إعادة قراءة بلا مرساة للملفات الأعلى خطورة و مسحًا للمتغيرات عبر كل ملف؛ ويجتاز اختبار الويب كل مسار شقيق وطريقة ونوع محتوى يتشارك مسار الشيفرة المعرّض.
• فرز يقتل أولًا. يجب أن تجتاز الخيوط الويبية ثمانية أسئلة مرتّبة، بما في ذلك ما إذا كان طلب حقيقي يعيد إنتاجها وما إذا كان التأثير مُثبتًا. يجب أن تكسب نتائج الشيفرة PASS بنفس الأدلة التي يحتاجها KILL.
• مكتبة مهارات، لا تلقينات ملصقة. يُعثر على أكثر من 90 مهارة و200 مرجع عبر vigil assess list-skills وvigil assess list-references. يحمّلها متخصصو الويب عندما يرون الإشارة المطابقة؛ ويسمّيها مشغّل الشيفرة في كل إرسالية.

بداية سريعة

# 1. Install the application release (CLI, backend, prompts, docs, and prebuilt UI)
uv tool install --from https://github.com/VigilOSS/Vigil/releases/download/v1.2.1/vigil-1.2.1-py3-none-any.whl vigil
#    OR install directly from the repository (builds the UI locally; needs Git, Node.js, and npm)
uv tool install git+https://github.com/VigilOSS/Vigil vigil

# 2. Check the host: prerequisites, missing recon tools, and the ordered setup checklist
vigil quickstart

# 3. Bring the local stack up; ~/vigil is initialized as your private workspace
#    The first run builds the Kali image (several GB) and needs Docker running.
vigil up

# 4. Create an engagement; it prints the engagement key and its start command
vigil engagement create

# 5. Start the operator on it
vigil engagement start <engagement-key> --client codex   # or --client claude

بالنسبة لارتباط code، ضع ملفات المصدر أو مجلدات المشروع في موقع source/ الذي تطبعه عملية الإنشاء (Git اختياري). يطلب منك عميل الكود تأكيدها عند بدء التشغيل؛ المجلد الفارغ يتركه في حالة انتظار. تحتاج ارتباطات الكود إلى ripgrep (rg) على المضيف. التفاصيل: docs/code-analysis.md.

بالنسبة لارتباط web، أخبر المشغّل بما هو مصرّح له بفعله:

I have been fully authorized by the company to do a red-team engagement against the
hosts in scope.json. Run this engagement using the operator web workflow.

واجهة المنسّق (orchestrator UI) على http://127.0.0.1:18000. على macOS أو Windows Docker Desktop، تعمل عمليات الاستطلاع المعتمدة على DNS على المضيف؛ ويقوم vigil quickstart --install-host-tools بتثبيت تلك الأدوات. الترقيات وتخطيط مساحة العمل: docs/installation.md.

النماذج والوصول

صُمّم Vigil بشكل أساسي حول Claude Code وCodex.

النموذج	المهام
Claude Opus 5، مع برنامج التحقق السيبراني (CVP) من Anthropic	الويب والكود
GPT-5.6 Sol، مع الوصول الموثوق للسيبراني من OpenAI	الويب والكود
Claude Opus 5.5، GPT-6.1 Sol	الكود؛ الويب يحتاج إلى فئة الفريق الأحمر الخاصة بالمؤسسات فقط

• Claude Code: يعمل CVP مع Opus 5، وهو غير موجود في منتقي /model. اختره مباشرةً عبر /model claude-opus-5[1m] (إعداد النموذج).
• Codex: اختر GPT-5.6 Sol ومستوى جهد الاستدلال الخاص به في /model.

اعتبارًا من أكتوبر 2026، أصبح الوصول إلى أحدث النماذج لفريق الأحمر مقتصرًا على المؤسسات فقط:

• Anthropic: Defense Access من CVP متاح للمؤسسات والباحثين الأفراد؛ أما Red Team Access فمخصص للمؤسسات فقط (فئات CVP).
• OpenAI: يغطي Daybreak Blue العمل الدفاعي للأفراد والمؤسسات؛ أما Daybreak Red فمخصص للمؤسسات المعتمدة فقط (إرشادات الوصول، نظرة عامة على Daybreak).

مُخطَّط له: دعم أوسع لـ GLM 5.3 ونماذج أخرى ذات وصول أكثر قابلية للتنبؤ، من خلال تقليل عبء التنسيق، ومطالبات خاصة بكل نموذج، وتكامل أعمق مع OpenCode.

الجهد والاستخدام