Skip to main content
OFFENSIVE AGENTIC ARCHITECTURE / CORE DETERMINISTIC ENGINE

AUTONOMOUS
AGENTIC VAPT
ORCHESTRATED.

HORCRUX breaks free from dumb scanners and unconstrained LLM chatbots. Built on an authoritative deterministic state engine with an advisory reasoning AI tier, it constructs deep behavioral application models, coordinates 11 specialist analysts, tracks 15 property-based security coverage domains, and correlates multi-step attack paths directly to verified exploit handoffs.

11 Specialist Roles No generic prompts
15 Property Domains Behavioral, not CVE counts
5 Enterprise Engines Tenable · Qualys · Rapid7+
100% Safety Gated Operator approval handoff
ROOT_ORCHESTRATOR :: LIVE EVALUATION
STATE.JSON SYNCED
ACTIVE TARGET target-corp.internal
ORCHESTRATION LOOP REASSESS [ITER 03]
ACTIVE SPECIALIST AuthorizationAnalyst
SAFETY POLICY AUTHORIZED / SAFE_ONLY
84 Endpoints · 12 Objects · 2 Identities
STRUCTURED EVENT STREAM (raw/events.jsonl) VERIFIED EVIDENCE ONLY
SAFETY BOUNDARY ENFORCED EXPLOIT HANDOFF PREPARED
Target: /api/v2/tenants/{id}/export BOLA Confirmed via Dual-Identity Swap
CapabilityRegistry: Strict Boundary Workers: 4 Concurrent AI Tier: Groq / Sonnet 3.5
MISSION CONTROL SYSTEM

The Orchestration Cockpit In Action

Experience how HORCRUX separates deterministic execution from advisory AI reasoning. Select any quadrant below to inspect the live engine mechanisms.

CYCLE LOGIC: ROOT_VAPT_ORCHESTRATOR

Deterministic Reassessment Loop

Unlike naive agent loops that hallucinate tool outputs, HORCRUX executes through authoritative state transitions. Every iteration updates the ApplicationModel, generates hypotheses, gates investigations by dependency prerequisites, schedules workers concurrently, and checks coverage completion criteria.

COMPLETION CRITERIA

Completion is evaluated strictly on coverage saturation + investigation exhaustion + unresolved hypothesis threshold. An assessment NEVER terminates simply because findings == 0.

Step 1 of 7
01

Ingestion & State Recovery

Load workspace, recover interrupted RUNNING investigations to READY, parse raw headers & responses.

Deterministic Sync
02

ApplicationModel Synthesis

Converge HTTP, JS analyzer, DOM forms, and crawler evidence into semantic routes and parameters.

Behavioral Model
03

Hypothesis Generation

Specialists propose candidate vulnerabilities with explicit proof and disproof conditions.

11 Analyst Roles
04

Dependency Gating & Ranking

Block investigations missing prerequisites (e.g. two_identities), unblock when evidence lands.

Priority Scheduler
05

Concurrent Batch Execution

Execute through CapabilityRegistry boundary with --workers N for independent tests.

CapabilityRegistry
06

Contradiction & Coverage Audit

Detect discrepancies between external observation vs live evidence. Update 15 property domains.

Audit Gate
07

Attack Path & Exploit Handoff

Assemble DAG attack paths. Prepare structured exploit intelligence with operator approval requirement.

ExploitHandoff Boundary
INTENT ROUTER :: 11 TYPED CLASSES

ask is a State Interface, Not a Chatbot

In HORCRUX, ask queries the authoritative WorkspaceState. Simple state queries never waste LLM tokens. When the model is consulted for prose reasoning, state changes occur exclusively through typed, validated AskAction objects.

CLICK QUICK QUERIES TO TEST:
OPERATOR CONTROLS

focus web|api|auth|authz|business-logic|network
pause · resume · skip <id> · prioritize <id> · why <id>

horcrux ask --target target-corp.internal
GRAPH THEORY IN OFFENSIVE VAPT

Directed Acyclic Attack Paths

HORCRUX graphs attack progression across identities, endpoints, objects, vulnerabilities, and trust boundaries. Crucially: every edge carries cryptographic or HTTP evidence. Edges based on inference are explicitly labeled with rationale.

Node: Discovered Surface / Credential
Node: Vulnerability Hypothesis (BOLA / BFLA)
Edge: Evidenced Transition (HTTP Proof)
Terminal: Exploit Handoff (Operator Boundary)
CLICK ANY NODE ON THE RIGHT TO INSPECT EVIDENCE
Select a node to inspect its evidence refs, prerequisites, and scoring rationale.
auth_token identity_swap id_enumeration privilege_grant bulk_export USER_A Low-Priv Identity /profile Session Valid BOLA Tenant IDOR BFLA Role Bypass HANDOFF Manual Approval
Click any node to see verification proof & HTTP artifacts
EXTERNAL INTEGRATION CONTROL PLANE

The Orchestrator of Vulnerability Engines

The researcher uses HORCRUX; HORCRUX orchestrates the external engines. Tenable, Qualys, Rapid7, Greenbone, and Microsoft Defender plug into a standardized contract (ExternalVulnerabilityEngine). Results enter as external observations and are correlated against live HTTP/Nmap evidence.

THE JUICE SHOP RULE (Coverage Transparency)

Missing engines are always explicitly declared. Reports state: "Results from unavailable engines are not represented as negative evidence." A 0-finding assessment renders as "No confirmed vulnerabilities within assessed scope and completed coverage" — NEVER "Target secure".

Tenable One VM CLOUD · API v2
Full scan lifecycle, dynamic template discovery, API token header X-ApiKeys.
● CONNECTED & CORRELATED
Qualys VMDR CLOUD · XML v2
POD-specific base URL, authenticated scan management, QID CVE correlation.
● CONNECTED & CORRELATED
Rapid7 InsightVM CONSOLE API v3
Security Console integration, dynamic site_id scope filtering, asset correlation.
● CONNECTED & CORRELATED
Greenbone / OpenVAS LOCAL GMP v22
Local/remote service protocol (:9390), GMP socket, offline scan lifecycle.
● DAEMON READY
Microsoft Defender VM INTEL CONNECTOR
Enterprise machine vulnerability intelligence. No fabricated network scan lifecycle.
● INTEL STREAM ACTIVE
SEMANTIC KNOWLEDGE REPRESENTATION

Beyond Flat Endpoint Lists: The Application Model

HORCRUX does not just collect URLs. It builds a live behavioral model of the target representing states, mutations, object lifecycles, and cryptographic session traces.

Endpoints & API Operations

Deduplicated METHOD /path/{id} view correlating browser DOM, JS bundles, HTTP crawler, and OpenAPI schemas.

  • Mutation & state-changing flags
  • Parameter classes: object_id, url_fetch, auth_credential
  • Provenance tracking (browser vs http vs js)

Multi-Identity Sessions

Tracks multiple researcher-configured accounts with zero secret leakage. Raw secrets are NEVER persisted in workspace state.

  • One-way token & cookie hashing only
  • compare_identities() primitive for BOLA
  • Automated privilege differential analysis

Object Lifecycles & Workflows

Maps create/read/update/delete lifecycles, workflow transitions, preconditions, and postconditions across multi-step flows.

  • Workflow state-skipping detection
  • Cart-to-checkout logic validation
  • Identity ownership boundary checks

GraphQL & Trust Boundaries

Introspection analysis, query depth auditing, field-level mutation permissions, and microservice trust boundary demarcation.

  • Mutation authorization checks
  • ServiceFact protocol normalization
  • Scope gate per redirect chain
TASK-SPECIFIC REASONING ROLES

11 Specialist Analysts. No Generic AI Prompts.

One generic "security assistant" cannot handle complex penetration testing. HORCRUX dynamically activates dedicated roles with scoped inputs, typed output schemas, and strict safety boundaries.

ROLE 01

ReconAnalyst

Maps network services, open ports, and software inventories into initial perimeter graphs.

Context: services, ports Cap: nmap_discovery
ROLE 02

WebAnalyst

Discovers routes, forms, DOM structures, and suppresses soft-404 / SPA catch-all baselines.

Context: endpoints, forms Cap: http_probe, content_disc
ROLE 03

APIAnalyst

Dissects REST and GraphQL endpoints, mutations, JSON schemas, and authorization borders.

Context: endpoints, schemas Cap: graphql_probe, param_fuzz
ROLE 04

AuthenticationAnalyst

Maps login, registration, password reset, JWT signature, and session lifecycle transitions.

Context: workflows, identities Cap: identity_switch, jwt_analyze
ROLE 05 · CRITICAL

AuthorizationAnalyst

Orchestrates cross-identity comparisons to prove BOLA (IDOR) and function privilege escalation.

Context: objects, identities Cap: authz_compare, id_swap
ROLE 06

BusinessLogicAnalyst

Identifies workflow sequence skipping, coupon reuse, and state-machine manipulation flaws.

Context: workflow_transitions Cap: browser_navigate, replay
ROLE 07

ClientSideAnalyst

Decompiles JavaScript webpack chunks, uncovers hidden API paths, and client trust assumptions.

Context: routes, js_bundles Cap: js_analyze, dom_snapshot
ROLE 08

EvidenceAnalyst

Normalizes observations, computes statistical confidence, and sanitizes sensitive credentials.

Context: raw_evidence, findings Cap: endpoint_validate
ROLE 09

ValidationAnalyst

Executes non-destructive proofs for SSRF, injection, and file-upload candidate hypotheses.

Context: hypotheses, coverage Cap: param_fuzz, safe_probe
ROLE 10

AttackPathAnalyst

Connects verified findings into end-to-end attack paths from unauthenticated access to domain compromise.

Context: findings, attack_paths Cap: graph_synthesizer
ROLE 11

ExploitIntelligenceAnalyst

Correlates verified software versions with public exploit intelligence and prepares ExploitHandoff packages.

Context: software, cve Cap: searchsploit, nuclei_scan
OBJECTIVE METRICS OVER SCANNER COUNTS

15 Security Property Coverage Domains

Traditional tools boast about raw finding counts (mostly noise). HORCRUX tracks mathematical coverage of application security properties, giving operators provable audit certainty.

94.2% OVERALL ASSESSED SURFACE
12 / 15 DOMAINS SATURATED
2 BLOCKED (REQUIRES IDENTITY_2)
0 FALSE NEGATIVE SUPPRESSIONS
Authentication100%
Session Security100%
Object Auth (BOLA)FINDING
Function Auth (BFLA)92%
Input Validation96%
Injection Defense94%
SSRF Surface100%
Business Logic88%
API & GraphQL95%
File Handling90%
Client-Side Security98%
Info DisclosureFINDING
Configuration Hardening96%
Infrastructure Perimeter100%
Web Surface Discovery100%
OFFLINE VERIFICATION & REPLAY

20 Synthetic Benchmarks & Deterministic Replay

Offensive AI systems must be rigorously benchmarked without touching external networks. HORCRUX includes 20 synthetic fixtures and records recon evidence to evidence-script.json for 100% reproducible offline replay.

01. fx_bola bench-bola.local BOLA / BFLA
02. fx_broken_auth bench-auth.local Auth Session
03. fx_business_logic bench-blogic.local Cart State
04. fx_ssrf bench-ssrf.local URL Fetch
05. fx_multistep_path bench-chain.local Chained Attack
06. fx_contradictory bench-contradict.local Contradiction
07. fx_provider_refusal bench-refusal.local AI Fallback
SCENARIO: fx_bola (bench-bola.local) GOLDEN ACCURACY: 100% PASS
# Synthetic Workspace Fixture:
Endpoints: /rest/user/login, /rest/users/{id}, /rest/basket/{id}
Parameters: id (path), basketId (path), email (body)
Credentials: user-a (test-identity)

# Golden Metric Expectations (horcrux.bench.golden):
✓ min_endpoints >= 2: PASSED
✓ hypothesis:idor_bola: PASSED
✓ investigation:authorization-bound: PASSED
✓ min_attack_paths >= 1: PASSED
✓ coverage:authorization: PASSED (Evidenced)

# Zero-Network Replay Command:
$ horcrux replay bench-bola --script evidence-script.json
[+] Rebuilt workspace without network socket allocation
[+] Reassessed hypotheses, coverage, and attack paths deterministically.
OPERATOR COCKPIT

Terminal First. Designed for Real Engagements.

From Kali Linux and macOS to containerized CI/CD operators. Install in under 60 seconds.

01
git clone https://github.com/aadithya-vimal/horcrux.git && cd horcrux
02
python3 -m venv .venv && source .venv/bin/activate
03
pip install -r requirements.txt && pip install -e .
04
horcrux doctor && horcrux settings status
OS Keyring Protection: API keys for Groq, OpenAI, Anthropic, Google, and Tenable are stored encrypted in your operating system keychain. Never in plaintext git commits.
REAL CLI COMMAND WORKFLOW READY TO RUN
$ horcrux scan 10.10.10.10 --profile full
# Native recon + Tenable/Qualys/Rapid7 correlation

$ horcrux assess 10.10.10.10 --workers 4
# Autonomous investigation loop with 4 concurrent workers

$ horcrux ask "Why is BOLA likely?"
# Query the authoritative ApplicationModel state directly

$ horcrux focus authz && horcrux pause
# Steer investigation priority or drain active subprocesses

$ horcrux replay target-corp --script script.json
# Offline benchmark replay with zero target packet emission

Autonomous Offensive Security.
Grounded in Evidence.

Stop sifting through hundreds of duplicate scanner alerts. Deploy HORCRUX to synthesize attack surfaces, uncover behavioral flaws, and execute verified penetration testing loops with complete operator control.

MIT License · Zero Secret Telemetry · Deterministic Safety Enforcement · Enterprise Ready