Whitebox pentest workflow from Hadrian Security. Checkpointed, file-based state.
Quick start
# Install
pip install openhack
# Run against a repo
openhack init-run <target> <git-url>
Or simply ask the agent:
Initiate a whitebox pentest on https://github.com/example/app.git
Flow (10 phases, human approves each)
openhack init-run— clone target, init run state- Select experts (12 OWASP families or subset)
openhack run-recon— surface discovery, writes routing-units.jsonlopenhack create-scenarios— router agent generates scenario backlog- Run scenario backlog — each scenario gets its own expert agent + evidence
openhack record-scenario-result— records finding candidatesopenhack render-finding-triage-prompt— triage prompt per candidateopenhack record-finding-triage— accepted/downgraded → final findingsopenhack validate-run— integrity check
Key principle
Recon is scouting only. Do NOT begin vulnerability analysis from recon alone. Each phase requires human approval before proceeding.