Recon Overview
XCloak Recon is an AI-orchestrated penetration testing platform — describe a goal in plain English, and it plans, runs, and reports a real security assessment using industry-standard tools. It's a separate product from XCloak Security Suite, currently in beta.
What it does
Traditional scanners run one tool at a time and dump raw output for a human to interpret. Recon's AI planner reads your stated goal, decides which tools to run and in what order, executes each one in an isolated Docker container, then re-analyzes the combined output to strip false positives before scoring and reporting on what's actually there.
Every scan is a human-in-the-loop process — the AI proposes follow-up actions (e.g. deeper enumeration on a newly discovered port), but nothing beyond the initial plan runs without your approval.
The pipeline
Every scan follows the same eight-step, auditable sequence:
- You describe a goal — e.g.
"Scan example.com for vulnerabilities" - The AI Planner (GPT-4o, Claude, or local Ollama) breaks it into concrete tasks
- The plan is validated before anything executes
- Docker tool execution — nmap → nuclei → gobuster, etc., each in its own container
- AI analysis — validates findings, removes false positives
- CVSS risk scoring, with automatic stop conditions
- AI task proposals for follow-up work — held for your approval
- AI report generation, exported as PDF
Every step streams live over WebSocket, so you watch the scan happen rather than waiting for a final result.
Architecture
| Layer | Role |
|---|---|
| Next.js Frontend | Dashboard, new-scan flow, findings, schedules, settings |
| FastAPI Backend | REST + WebSocket API, JWT auth, rate limiting |
| Execution Engine | Planner → validator → controller → parser → analyzer → risk engine → task proposer → report generator |
| Docker Workers | 7 isolated security-tool containers |
| Data & Queue | PostgreSQL, Redis, and the configured LLM provider (Ollama / OpenAI / Claude) |
Tech stack
| Layer | Technology |
|---|---|
| Frontend | Next.js 15, TypeScript, Tailwind CSS |
| Database | Supabase (PostgreSQL via Prisma) |
| Storage | Supabase Storage |
| Scan Engine | FastAPI, Python 3.12 |
| Scan Tools | Docker — nmap, nuclei, gobuster, nikto, ffuf, sqlmap, whatweb |
| AI | Ollama (local) / OpenAI GPT-4o / Anthropic Claude — switchable at runtime |
| Threat Intel | NVD API, AlienVault OTX |
| Payments | Razorpay |