Raven Recon – An open-source security research framework with AI agents A developer publishing under the GitHub handle 9illcodelli6-cpp69cve released Raven Recon, an open-source, scope-aware reconnaissance and security-testing workbench for bug-bounty hunters and penetration testers that runs on Windows and Kali Linux as a desktop app, local web UI, or terminal. Raven Recon pairs certificate-transparency subdomain discovery, HTTP probing, endpoint discovery from links, robots.txt, sitemaps and JavaScript, and a request lab with an AI agent powered by Claude Opus 5.5 that plans tasks using the tool's playbooks but requires user approval for every request to a target and every command. The tool blocks out-of-scope and private addresses per workspace and adds an Emergency Stop, per-run budget and rate limits, an offline command sandbox on Linux, and encrypted API keys, with official builds distributed only via the repository's Releases page with SHA256SUMS.txt and a GitHub build-provenance attestation. Scope-aware reconnaissance and AI-assisted security-testing workbench — for bug-bounty hunters and penetration testers. Runs on Windows and Kali Linux as a desktop app, a local web UI, or in the terminal. Authorised testing only. Use RAVEN Recon only on systems you own or have written permission to test. Read RESPONSIBLE USE.md https://github.com/9illcodelli6-cpp69cve/raven-recon/blob/main/RESPONSIBLE USE.md first. العربية: README.ar.md https://github.com/9illcodelli6-cpp69cve/raven-recon/blob/main/README.ar.md ⚠️ | AI Agent — every request and command waits for your approval | Recon Workbench — attack surface, request lab, findings | |---|---| | Area | What you get | |---|---| | Scope & workspaces | One workspace per program: in-scope hosts and wildcards, exclusions, ports. Every request RAVEN sends is checked against it; out-of-scope and private addresses are blocked. | | Recon | Certificate-transparency subdomains, HTTP probing of every scoped port, endpoint discovery from links, robots.txt , sitemaps and JavaScript, change tracking between runs, priority scoring. | | Request lab | Repeater, Intruder headers, body, baseline anomaly detection , Decoder, HTTP history. | | Labs | Access-control lab compare two identities on the same resource and XSS lab reflection-context analysis, no script execution . | | Findings & evidence | Candidate findings with evidence links, review workflow, Markdown workspace report export. | | AI agent | Claude Opus 5.5 plans and works through a task with RAVEN's tools — every request to a target and every command waits for your Approve . Loads RAVEN's testing playbooks API recon, API security, recon breadth, code audit, patch diff, PHP LFI, browser testing . | | AI chat & terminal | Ask questions, get payloads and code raven-sec in the terminal . | | Safety | Emergency Stop, per-run budget and rate limits, offline command sandbox on Linux, encrypted API key, local-only data. | Option A — ready-to-run app recommended : 1. Download RAVEN-Recon-windows-x64.zip from the Releases page https://github.com/9illcodelli6-cpp69cve/raven-recon/releases/latest . 2. Verify it verify-your-download , unzip it, and run RAVEN.exe . Windows 10/11 with the Edge WebView2 runtime, which is built into Windows 11. Option B — from source needs Python 3.11+ https://www.python.org/downloads/ — or winget install -e --id Python.Python.3.12 — and Git https://git-scm.com/ , in PowerShell: git clone https://github.com/9illcodelli6-cpp69cve/raven-recon.git cd raven-recon powershell -ExecutionPolicy Bypass -File .\install.ps1 This creates a private Python environment, a Start Menu entry , and the commands raven-recon , raven-recon-web and raven-sec open a new terminal afterwards . Uninstall: .\install.ps1 -Uninstall your data is kept . Option A — ready-to-run app: download RAVEN-Recon-linux-x64.tar.gz and SHA256SUMS.txt from the Releases page, then: sha256sum -c SHA256SUMS.txt --ignore-missing tar -xzf RAVEN-Recon-linux-x64.tar.gz sudo apt install -y gir1.2-webkit2-4.1 bubblewrap own window + command sandbox ./RAVEN/RAVEN Option B — from source recommended on Kali : git clone https://github.com/9illcodelli6-cpp69cve/raven-recon.git cd raven-recon ./install.sh The installer asks before running sudo apt install for the few system packages it needs python3-venv python3-gi gir1.2-webkit2-4.1 bubblewrap , creates .venv , adds RAVEN Recon to the applications menu and installs the raven-recon and raven-sec commands in ~/.local/bin . Uninstall: ./install.sh --uninstall your data is kept . Official builds exist only on this repository's Releases page. Each release has SHA256SUMS.txt and a GitHub build-provenance attestation proving the file was built by this repository's workflow: sha256sum -c SHA256SUMS.txt --ignore-missing gh attestation verify RAVEN-Recon-linux-x64.tar.gz --repo 9illcodelli6-cpp69cve/raven-recon Windows: Get-FileHash .\RAVEN-Recon-windows-x64.zip -Algorithm SHA256 and compare with SHA256SUMS.txt . Copies from anywhere else "PRO", "cracked", re-uploads are not official and may be malicious. | | Windows | Kali / Linux | |---|---|---| | Desktop app own window | Start Menu → RAVEN Recon, or raven-recon | Menu → RAVEN Recon, or raven-recon | | Local web UI your browser, 127.0.0.1 only | raven-recon-web | raven-recon --browser | | Terminal assistant | raven-sec | raven-sec | The web UI listens on the loopback interface only and every API call needs a per-session token, so other machines on your network cannot reach it. 1. Create a workspace — RAVEN OS sidebar → Workspace or in the Recon Workbench: workspace menu → new workspace . Enter the program name and exactly the scope the program allows : in-scope hosts or wildcards .example.com , exclusions, and ports. Leave allow private addresses off unless it is your own lab. 2. Set your identity — Workbench → Identity : the User-Agent and the researcher header your program asks for for example X-HackerOne-Research: