**Windows** (PowerShell، x64 و arm64):```powershell
irm https://raw.githubusercontent.com/JoasASantos/NeuroSploit/main/install.ps1 | iex

## ⚡ بدء سريع (60 ثانية)```bash
# easiest path — just run it; the interactive session asks everything:
neurosploit

# or one-liner (subscription login, no API key needed):
neurosploit run http://testphp.vulnweb.com/ --subscription --model anthropic:claude-opus-4-8 -v

# white-box — review a source repository (SAST agents, file:line evidence):
git clone https://github.com/digininja/DVWA /tmp/DVWA
neurosploit whitebox /tmp/DVWA --subscription --model anthropic:claude-opus-4-8 -v

# grey-box — review the code AND exploit the running app together:
neurosploit greybox /tmp/DVWA --url http://localhost:8080/ --creds creds.yaml \
  --subscription --model anthropic:claude-opus-4-8 --mcp -v

# host / infra — Linux / Windows / Active Directory (SSH/Win creds in creds.yaml):
neurosploit host 10.0.0.10 --creds creds.yaml --subscription --model anthropic:claude-opus-4-8 -v

# 🛰  Mission Control TUI — live panels (header/feed/findings/targets) + a composer
#    you can type in WHILE the run streams (summary · pause · errors · notes):
neurosploit tui http://testphp.vulnweb.com/ --subscription --model anthropic:claude-opus-4-8 --mcp

صفر اعتماديات npm (وحدات Node المدمجة فقط).

- **معالج مهمة من 5 خطوات** — الأصل (الوضع + الهدف/المستودع) ← النطاق والمصادقة (الهدف، التركيز،
  خارج النطاق) ← الخيوط (لوحة الوكلاء الـ435 أدناه) ← النموذج والتشغيل (منتقي المزود/النموذج،
  زر تبديل بين مفتاح API والاشتراك، الأصوات/عمق السلسلة/الاستطلاع) ← المراجعة. تُسمّى كل مهمة
  مسبقًا، بحيث يمكن التعرف على عمليات التشغيل في السجل بدلاً من السلسلة النصية الخام للهدف.
- **لوحة الخيوط** — جميع الوكلاء الـ435 مصنفون تلقائيًا (منطق الأعمال، التحكم المكسور في الوصول،
  الحقن، تطبيق LLM، المصادقة والجلسات، SSRF والشبكة، السحابة والبنية التحتية، …). بدّل خيطًا واحدًا،
  أو فئة كاملة (بحالة غير محددة عند التحديد الجزئي)، أو استخدم **تحديد الكل / مسح الكل** — يحترم
  فلتر البحث النشط. اترك كل شيء معطلاً ليختار الإطار بنفسه بناءً على الاستطلاع.
- **خيط مخصص ← وكيل حقيقي** — لا يضيف «+ خيط مخصص» مجرد تلميح نصي: بل يستدعي واجهة سطر الأوامر `claude`
  (Opus، اشتراكك في Anthropic) لإنشاء ملف markdown فعلي لوكيل متخصص داخل `agents_md/vulns/`،
  بنفس التنسيق الذي يستخدمه كل وكيل مدمج، ويمكن تثبيته فورًا. يتراجع إلى تلميح نص تركيز بسيط إذا
  لم يكن Claude متاحًا.
- **عرض التشغيل المباشر** — يُبث المرحلة/التقدم عبر SSE من مخرجات stdout الخاصة بواجهة CLI، مع
  جدول النتائج، و**الربط التوليدي لمسارات الهجوم**: رسم بياني من العقد/الحواف (الجذر = الهدف، عقدة
  واحدة لكل نتيجة مؤكدة، متمركزة حسب مرحلة سلسلة القتل، وحواف من `chains_from` عندما يحددها الإطار)
  بدلاً من قائمة مسطحة — انقر على أي عقدة أو صف لعرض تفاصيل النتيجة كاملة، بما في ذلك أي سكربت PoC
  كتبه الوكيل المستغل في `pocs/`.
- **المصادقة والمفاتيح** (قائمة واحدة) — ترويسة مصادقة الهدف + أدوار مسماة لاختبار IDOR/BOLA/BFLA
  (تُنشئ `creds.yaml` مؤقتًا للتشغيل)، ومفاتيح API لكل مزود تُحفظ في ذاكرة عملية الخادم فقط —
  لا تُكتب أبدًا على القرص.
- يبقى سليمًا بعد تحديث الصفحة: يعيد التشغيل الجاري الاتصال بنفس البث المباشر بدلاً من
  إعادة التعيين إلى المعالج.

مرجع API الكامل: **[web/API.md](https://github.com/joasasantos/neurosploit/blob/HEAD/web/API.md)** · بدء سريع: **[web/README.md](https://github.com/joasasantos/neurosploit/blob/HEAD/web/README.md)**.

---

## 🔌 التكاملات (GitHub · GitLab · Jira)

أدرج NeuroSploit في دورة حياة تطوير برمجياتك (SDLC). يمكنك التبديل من REPL (`/integrations`) أو من CLI
(`neurosploit integrations enable github|gitlab|jira`). **لا تُخزَّن الرموز أبدًا**
— يُحفظ فقط *اسم* متغير البيئة؛ وتُقرأ القيمة من بيئتك.```bash
export GITHUB_TOKEN=ghp_...                 # PAT with `repo` scope (private repos)
neurosploit integrations enable github

# Review a Pull Request's code (clones the PR head, white-box) and comment back:
neurosploit pr digininja/DVWA 42 --subscription --model anthropic:claude-opus-4-8 --comment

# Same, but BLOCK the merge on a confirmed critical: fails the check, sets a
# `neurosploit/security` commit status, and posts a REQUEST_CHANGES review.
neurosploit pr digininja/DVWA 42 --model anthropic:claude-opus-4-8 --comment --fail-on critical

# Watch a branch and re-review on every new commit:
neurosploit watch myorg/private-app --branch main --subscription --model anthropic:claude-opus-4-8

# Private GitLab repo (token-injected clone) — works in whitebox/greybox:
export GITLAB_TOKEN=glpat-... ; neurosploit integrations enable gitlab
neurosploit whitebox https://gitlab.com/myorg/private-svc --subscription --model anthropic:claude-opus-4-8

# Open a Jira card per finding (any engagement):
export [email protected] JIRA_API_TOKEN=...      # set base/project once: /integrations setup jira
neurosploit whitebox https://github.com/myorg/app --jira --subscription --model anthropic:claude-opus-4-8

Please provide the Markdown content to translate.```bash
neurosploit host my-cloud-account --creds creds.yaml \
  --subscription --model anthropic:claude-opus-4-8 -v

(No content provided for translation)```bash
neurosploit run https://app.example --creds creds.yaml \
  --subscription --model anthropic:claude-opus-4-8 -v

يتطلب سلسلة أدوات Rust (`rustup`). **موصى به: التشغيل على Kali Linux** (أو
صورة Kali Docker) بحيث تكون الأدوات الهجومية التي يستخدمها الوكلاء موجودة بالفعل:```bash
docker run -it --rm kalilinux/kali-rolling
apt update && apt install -y curl nmap ffuf nodejs npm
# rustscan (faster port scan): cargo install rustscan   (or grab a release from GitHub)

أو قم بتشغيله مباشرة:```bash
# Black-box — subscription (no API key), Opus, browser via Playwright if present, verbose
./target/release/neurosploit run http://testphp.vulnweb.com/ \
    --subscription --model anthropic:claude-opus-4-8 --mcp -v

# Black-box — API keys, multi-model voting panel (1st finds, others adjudicate)
./target/release/neurosploit run http://testphp.vulnweb.com/ \
    --model anthropic:claude-opus-4-8 --model openai:gpt-5.1 --vote-n 3

# White-box — clone a vulnerable app and review its source
git clone https://github.com/digininja/DVWA /tmp/DVWA
./target/release/neurosploit whitebox /tmp/DVWA \
    --subscription --model anthropic:claude-opus-4-8 -v

# Offline pipeline self-test (no keys/login needed)
./target/release/neurosploit run http://testphp.vulnweb.com/ --offline

# Utilities
./target/release/neurosploit agents     # library counts
./target/release/neurosploit models      # providers & models
./target/release/neurosploit --help        # full help with examples

أو ضع المفاتيح في ملف `.env` وقم بتحميله (source) (`cp .env.example .env`; عدّل; `set -a; . ./.env; set +a`).

**المزوّد → متغير البيئة → نقطة النهاية** (جميعها متوافقة مع OpenAI):

| بادئة `--model` | متغير البيئة | الرابط الأساسي |
|------------------|---------|----------|
| `anthropic:` | `ANTHROPIC_API_KEY` | api.anthropic.com |
| `openai:` | `OPENAI_API_KEY` | api.openai.com |
| `gemini:` | `GEMINI_API_KEY` | generativelanguage.googleapis.com |
| `xai:` | `XAI_API_KEY` | api.x.ai |
| `nvidia_nim:` | `NVIDIA_NIM_API_KEY` | integrate.api.nvidia.com |
| `deepseek:` | `DEEPSEEK_API_KEY` | api.deepseek.com |
| `mistral:` | `MISTRAL_API_KEY` | api.mistral.ai |
| `qwen:` | `DASHSCOPE_API_KEY` | dashscope-intl.aliyuncs.com |
| `groq:` | `GROQ_API_KEY` | api.groq.com |
| `together:` | `TOGETHER_API_KEY` | api.together.xyz |
| `moonshot:` | `MOONSHOT_API_KEY` | api.moonshot.ai |
| `openrouter:` | `OPENROUTER_API_KEY` | openrouter.ai |
| `opencode:` | `OPENCODE_API_KEY` | opencode.ai/zen (بوابة OpenCode Zen) |
| `nous:` | `NOUS_API_KEY` | inference-api.nousresearch.com (Hermes 4) |
| `litellm:` | `LITELLM_API_KEY` | خادم LiteLLM الوسيط الخاص بك (`LITELLM_BASE_URL`، الافتراضي localhost:4000) |
| `azure:` | `AZURE_OPENAI_API_KEY` | مورد Azure OpenAI الخاص بك (`AZURE_OPENAI_ENDPOINT`) |
| `ollama:` | _(لا يوجد)_ | localhost:11434 |
| `llamacpp:` | _(لا يوجد)_ | localhost:8080 |

شغّل `./target/release/neurosploit models` للحصول على القائمة الكاملة للمزوّدين/النماذج.

> **محلي، غير خاضع للرقابة، ويعمل على المعالج فقط** — يعمل `ollama:` و`llamacpp:` بالكامل على
> جهازك دون مفتاح API ودون مغادرة أي بيانات للجهاز المضيف. يستهدف `llamacpp:` نقطة نهاية
> متوافقة مع OpenAI عبر [`llama-server`](https://github.com/ggml-org/llama.cpp)
> (يمكن تجاوزها باستخدام `LLAMACPP_BASE_URL`)؛ و`model` هو أي ملف gguf قمت بتحميله.
> مثالي للعمليات دون اتصال وللبرومبتات الهجومية غير المفلترة.

#### 2) عبر الاشتراك (بدون مفتاح API)

يستخدم `--subscription` تسجيل دخول واجهة CLI المحلية العاملة بالعوامل (agentic CLI) بدلاً من مفتاح API — ثبّت إحدى هذه الواجهات وسجّل الدخول إليها أولاً:

| بادئة `--model` | CLI المستخدمة | تسجيل الدخول |
|------------------|----------|-------|
| `anthropic:` | `claude` (Claude Code) | `claude` ثم `/login` |
| `openai:` | `codex` | `codex` login |
| `gemini:` | `gemini` | `gemini` login |
| `xai:` | `grok` | `grok` login |
| `opencode:` | `opencode` | `opencode auth login` (أو `/connect` من واجهة TUI) — حساب Zen/plan |
| `nous:` | `hermes` | `hermes setup --portal` — Nous Portal OAuth |

يحصل `opencode:` أيضًا على Playwright MCP (`--mcp`) مثلما هو الحال مع anthropic/openai.
يعتمد `nous:` على مجموعات الأدوات المدمجة الخاصة بـ Hermes (web/terminal/computer-use)
بدلاً من ذلك — إذ لا يتوفر لديه خطاف MCP على مستوى CLI.```bash
./target/release/neurosploit run http://testphp.vulnweb.com/ \
    --subscription --model anthropic:claude-opus-4-8 --mcp -v

كل عملية تشغيل تنشئ مجلدًا مكتفيًا بذاته `runs/ns-<ts>-<target>/`:

| الملف | المحتويات |
|------|----------|
| `status.json` | `running` → `complete` مع ملخص |
| `recon.json` / `recon.md` | سطح الهجوم المُحدد |
| `exploitation.md` | النص الخام لسجل كل وكيل |
| `findings.json` / `findings.md` | نتائج مُتحقق منها (لإعادة استخدامها بواسطة أدوات/أنظمة ذكاء اصطناعي أخرى) |
| `report.html`, `report.typ`, `report.pdf` | التقرير النهائي (PDF عبر محرك Typst) |

مخزن مكافآت التعلّم المعزّز (`data/rl_state_rs.json`) يوجّه اختيار الوكلاء في عمليات التشغيل المستقبلية.

## مكتبة الوكلاء — `agents_md/` (435)

| الفئة | العدد | الغرض |
|----------|-------|---------|
| `vulns/` | 245 | استغلال فئة محددة من الثغرات (ويب/API) |
| `code/` | 78 | مراجعة الكود المصدري (SAST) بأسلوب الصندوق الأبيض |
| `ai/` | 30 | الاختبار العدائي للذكاء الاصطناعي/LLM، والـ jailbreaks، وتهديدات MCP |
| `infra/` | 34 | المضيف/السحابة: Linux وWindows وAD وAWS/GCP/Azure |
| `meta/` | 23 | المنسّق، والمدقّق، والمُقيّمون، ومُعدّ التقارير، والتعلم المعزز (RL) |
| `chains/` | 13 | سلاسل هجوم متعددة المراحل (SQLi→RCE→LPE، SSRF→السحابة، …) |
| `recon/` | 12 | جمع المعلومات / سطح الهجوم |

كل وكيل هو دليل لعب Markdown مكتفٍ بذاته (منهجية `## User Prompt` +
قواعد صارمة لمنع النتائج الإيجابية الخاطئة في `## System Prompt`). ضع ملف `.md` جديدًا في
المجلد المطابق — أو أنشئ واحدًا من وحدة تحكم الويب عبر "+ Custom lead" (انظر أعلاه) — والمنصة
تلتقطه؛ ويعرض `neurosploit agents` العدادت المباشرة.

---

## السلامة

للاختبارات **المصرّح بها** فقط. يُوجَّه الوكلاء للبقاء ضمن النطاق، وعدم تشغيل
إجراءات تخريبية/حجب خدمة (DoS) أبدًا، والمطالبة بإثبات نجاح الاستغلال. أنت مسؤول عن
الحصول على إذن لأي هدف.

## الاعتمادات

**Joas A Santos** و**قادة الفريق الأحمر**.

## الترخيص

MIT.