reconFTW is a tool designed to perform automated recon on a target domain by running the best set of tools to perform scanning and finding out vulnerabilities
Shell bug-bountybugbountybugbounty-tooldnshackingnucleiosintpenetration-testingpentestpentest-toolpentestingreconreconnaissancescannersecuritysecurity-toolssubdomainsubdomain-enumerationvulnerabilities
Technology Stack
Analysis Date: 2026-05-13
Languages
Primary:
- Bash 4+ - All core framework logic (
reconftw.sh,modules/*.sh,lib/*.sh,install.sh)- Requires Bash ≥ 4 (uses
mapfile, associative arrays,wait -n) - macOS ships Bash 3; installer auto-re-execs with Homebrew Bash 4+ via
/opt/homebrew/bin/bashor/usr/local/bin/bash set -o pipefail,set -E,set +e,IFS=$'\n\t'used throughout
- Requires Bash ≥ 4 (uses
Secondary:
- Python 3.7+ - Python-backed tools (each runs in isolated
uv venv):dorks_hunter,CMSeeK,EmailHarvester,Spoofy,SSTImap,gato,regulator,reconftw_ai,getjswords.py - Go (latest, min ~1.21) - Primary binary language for ~55 security tools installed via
go install @latest
Runtime
Environment:
- Linux (Debian/Ubuntu/RHEL/Arch) or macOS (Apple Silicon / Intel)
- Docker: Ubuntu 24.04 base image (
Docker/Dockerfile) - ARM64/aarch64, ARMv6l/v7l, and x86_64 all supported for Go binary installs
Shell Features Used:
getopt(GNU getopt required on macOS viabrew install gnu-getopt)nproc/sysctl -n hw.ncpufor CPU core auto-detectiontimeout/gtimeout(macOS Homebrewcoreutils)gnu-sed(macOS requiresbrew install gnu-sed)gnu-coreutils(macOS requiresbrew install coreutils)
Package Manager:
- Go tools:
go install(GOPATH=$HOME/go,GOROOT=/usr/local/go) - Python tools:
uv tool installfrom GitHub (most) or PyPI (fray) - Python repo venvs:
uv venv venv && uv pip install -r requirements.txt - Lockfile: None (always installs
@latest)
Frameworks
Core:
- No framework — pure Bash with sourced module files
- Module loading order:
lib/validation.sh→lib/common.sh→lib/ui.sh→lib/parallel.sh→modules/utils.sh→modules/core.sh→modules/osint.sh→modules/subdomains.sh→modules/web.sh→modules/vulns.sh→modules/axiom.sh→modules/modes.sh
Testing:
- bats-core (Bash Automated Testing System)
- 25 unit test files:
tests/unit/*.bats - 3 security test files:
tests/security/*.bats - Run:
bats tests/unit/,bats tests/security/*.bats
- 25 unit test files:
Build/Dev:
- GNU make (
Makefile) — test, lint, format targets - shellcheck (error-level) —
make lint, pre-commit hook - shfmt (4-space indent,
-bn,-ci) —make fmt, pre-commit hook - pre-commit hooks defined in
.pre-commit-config.yaml - semgrep:
.github/workflows/semgrep.yml(CI only)
Key Dependencies
Go Tools (installed via go install @latest)
Subdomain Enumeration:
subfinder(projectdiscovery/subfinder) — passive multi-source subdomain discoverygithub-subdomains(gwen001/github-subdomains) — GitHub-based subdomain searchgitlab-subdomains(gwen001/gitlab-subdomains) — GitLab-based subdomain searchdnstake(pwnesia/dnstake) — subdomain takeover detectionpuredns(d3mondev/puredns) — mass DNS resolution with wildcard filteringdnsx(projectdiscovery/dnsx) — DNS toolkitmassdns(blechschmidt/massdns) — via repo clone + builddsieve(trickest/dsieve) — subdomain filteringenumerepo(trickest/enumerepo) — GitHub org repo enumerationgotator(Josue87/gotator) — subdomain permutationsanalyticsrelationships(Josue87/analyticsrelationships) — Google Analytics pivotingroboxtractor(Josue87/roboxtractor) — robots.txt extractorcrt(cemulus/crt) — crt.sh searchasnmap(projectdiscovery/asnmap) — ASN-to-CIDR mappingmapcidr(projectdiscovery/mapcidr) — CIDR manipulationsmap(s0md3v/smap) — passive Shodan-powered port scantlsx(projectdiscovery/tlsx) — TLS certificate harvestinghakip2host(hakluke/hakip2host) — reverse IP lookupcdncheck(projectdiscovery/cdncheck) — CDN/WAF IP classificationhakoriginfinder(hakluke/hakoriginfinder) — origin IP discovery behind CDNinscope(tomnomnom/hacks/inscope) — scope filteringcsprecon(edoardottt/csprecon) — CSP-based subdomain discoveryfavirecon(edoardottt/favirecon) — favicon-based tech recon
HTTP / Web Probing:
httpx(projectdiscovery/httpx) — multi-probe HTTP toolkitkatana(projectdiscovery/katana) — web crawlerffuf(ffuf/ffuf) — web fuzzersubjs(lc/subjs) — JavaScript URL extractorGxss(KathanP19/Gxss) — reflected XSS param finderjsluice(BishopFox/jsluice) — JS secret/URL extractorsourcemapper(denandz/sourcemapper) — JS source map extractormantra(brosck/mantra) — JS/secret scannerurlfinder(projectdiscovery/urlfinder) — URL discoveryxnLinkFinder(xnl-h4ck3r/xnLinkFinder) — via uvnmapurls(sdcampbell/nmapurls) — URL extraction from Nmap XMLnaabu(projectdiscovery/naabu) — fast port scannerVhostFinder(wdahlenburg/VhostFinder) — virtual host discoveryshortscan(bitquark/shortscan) — IIS short filename scanner
Vulnerability Detection:
nuclei(projectdiscovery/nuclei) — template-based scannerdalfox(hahwul/dalfox) — XSS scannercrlfuzz(dwisiswant0/crlfuzz) — CRLF injection scannerWeb-Cache-Vulnerability-Scanner(Hackmanit) — web cache poisoningTInjA(Hackmanit/TInjA) — SSTI scannertoxicache(xhzeem/toxicache) — web cache poisoningsecond-order(mhmdiaa/second-order) — broken link/second-order injections3scanner(sa7mon/s3scanner) — S3/GCS/Azure Blob misconfigurationmisconfig-mapper(intigriti/misconfig-mapper) — third-party misconfigurationsj(BishopFox/sj) — Swagger/OpenAPI analysisgrpcurl(fullstorydev/grpcurl) — gRPC reflection scannernerva(praetorian-inc/nerva) — service fingerprintingbrutus(praetorian-inc/brutus) — credential sprayingjulius(praetorian-inc/julius) — LLM endpoint probetitus(praetorian-inc/titus) — secrets engine
OSINT / Recon:
notify(projectdiscovery/notify) — multi-channel notificationsinteractsh-client(projectdiscovery/interactsh) — OOB callback servergf(tomnomnom/gf) — URL pattern grepanew(tomnomnom/anew) — append new lines onlyunfurl(tomnomnom/unfurl) — URL parserqsreplace(tomnomnom/qsreplace) — querystring replacergitdorks_go(damit5/gitdorks_go) — GitHub dork searchgithub-endpoints(gwen001/github-endpoints) — GitHub endpoint discoverycent(xm1k3/cent) — nuclei template managertrufflehog(trufflesecurity/trufflehog) — secrets scanner (viago install)
Spraying / Auth:
brutespray(x90skysn3k/brutespray) — service credential spraying
Python Tools (installed via uv tool install)
dnsvalidator(vortexau/dnsvalidator) — DNS resolver validationinterlace(pry0cc/interlace) — parallel command runnerwafw00f(EnableSecurity/wafw00f) — WAF fingerprintingcommix(commixproject/commix) — command injection scannerwaymore(xnl-h4ck3r/waymore) — passive URL collectionurless(xnl-h4ck3r/urless) — URL deduplicationghauri(r0oth3x49/ghauri) — SQLi scanner (optional)xnLinkFinder(xnl-h4ck3r/xnLinkFinder) — deep link finderxnldorker(xnl-h4ck3r/xnldorker) — Google dorkerporch-pirate(MandConsultingGroup/porch-pirate) — Postman API leaksp1radup(iambouali/p1radup) — URL deduplicationsubwiz(hadriansecurity/subwiz) — ML-based subdomain predictionarjun(s0md3v/Arjun) — parameter discoverygqlspection(doyensec/GQLSpection) — GraphQL deep introspectionpostleaksNg(six2dez/postleaksNG) — Postman public leak searchcewler(roys/cewler) — web wordlist generatorfray(dalisecurity/fray) — WAF-aware payload testing (PyPI)
Repo-Clone Tools (Python venvs, run via venv/bin/python3)
dorks_hunter(six2dez/dorks_hunter) — Google dork automationCMSeeK(Tuhinshubhra/CMSeeK) — CMS fingerprintingcloud_enum(initstring/cloud_enum) — AWS/GCP/Azure bucket enumerationEmailHarvester(maldevel/EmailHarvester) — email harvestingSwaggerSpy(UndeadSec/SwaggerSpy) — Swagger endpoint leak detectionLeakSearch(JoelGMSec/LeakSearch) — credential leak searchSpoofy(MattKeeley/Spoofy) — email spoofing checkmsftrecon(Arcanum-Sec/msftrecon) — Microsoft tenant reconScopify(Arcanum-Sec/Scopify) — scope managementregulator(cramppet/regulator) — regex-based subdomain permutationsSSTImap(vladko312/SSTImap) — SSTI scanner (alternative engine)gato(praetorian-inc/gato) — GitHub Actions audit
Repo-Clone Tools (Go build)
ghleaks(dinosn/ghleaks) — GitHub-wide secret searchnomore403(devploit/nomore403) — 403 bypassffufPostprocessing(Damian89/ffufPostprocessing) — ffuf result analysisJSA(w9w/JSA) — JS analysisultimate-nmap-parser(shifty0g/ultimate-nmap-parser) — Nmap XML parser
System-Level Tools (apt/brew/yum)
nmap— active port scanningmassdns— DNS resolver (also cloned + built from source)jq— JSON processing throughout all modulesexiftool(perl-Image-ExifTool) — metadata extractionwhois— domain registration lookupsqlmap— SQL injection (system or via repo clone)testssl.sh(testssl/testssl.sh) — TLS/SSL misconfiguration testingmedusa— credential brute-force (system install)shodanCLI — installed viauv tool install shodan
Rust Tools
smugglex(Cargo) — HTTP request smuggling detection- Rustup installed from
https://sh.rustup.rs
Configuration
Primary Config:
reconftw.cfg— sourced after CLI parsing; all feature flags, rate limits, timeouts, wordlist paths, API keys, thread countssecrets.cfg(gitignored, auto-sourced) — API keys and tokens separated from main configsecrets.cfg.example— template showing all supported secret vars
Config Structure:
- Feature flags:
OSINT=true,SUBDOMAINS_GENERAL=true,VULNS_GENERAL=false, etc. - Rate limits:
HTTPX_RATELIMIT=150,NUCLEI_RATELIMIT=150,FFUF_RATELIMIT=0 - Thread counts: auto-scaled via
AVAILABLE_CORES=$(nproc)with multipliers per tool - Timeouts: per-tool in seconds or minutes (
CMSSCAN_TIMEOUT=3600,SUBFINDER_ENUM_TIMEOUT=180) - Wordlist paths:
fuzz_wordlist,lfi_wordlist,subs_wordlistetc. under${WORDLISTS_DIR} - Output:
EXPORT_FORMAT,AI_REPORT_TYPE,ASSET_STORE
CLI Flag Parsing:
- GNU
getoptlong options, parsed inreconftw.shwhile/case loop - All CLI overrides use
CLI_*pattern and are re-applied afterreconftw.cfgis sourced - Full list from
getoptcall:domain,list,recon,subdomains,passive,all,web,osint,zen,deep,help,vps,vps-count,ai,check-tools,health-check,quick-rescan,incremental,adaptive-rate,dry-run,parallel,no-parallel,monitor,monitor-interval,monitor-cycles,refresh-cache,gen-resolvers,force,export,report-only,no-report,parallel-log,quiet,verbose,no-color,log-format,show-cache,banner,no-banner,legal
Environment Variables:
SHODAN_API_KEY,WHOISXML_API,PDCP_API_KEY,XSS_SERVER,COLLAB_SERVER— preferred over config fileGOROOT,GOPATH,PATH— extended byreconftw.cfgfor Go and Rust binariesLOGFILE— per-target log path
Config Presets:
config/reconftw_full.cfg— full-scan presetconfig/reconftw_quick.cfg— quick-scan presetconfig/reconftw_stealth.cfg— low-noise preset
Build
Go Version:
- Default:
go1.23.6(fetches latest fromhttps://go.dev/VERSION?m=text) - Installed to
/usr/local/go; setinstall_golang=falsein config to skip
Python Version:
- Minimum: Python 3.7 (enforced in
install_yum()) - Virtual environments per tool via
uv venv - Root venv at
.venv/forgetjswords.pyand similar helpers
Platform Requirements
Development (Linux/macOS):
- Bash ≥ 4.3 (for
wait -nused inlib/parallel.sh) - Go ≥ 1.21 (tools use SIV module paths like
/v2,/v3) - Python ≥ 3.7
uvpackage manager- Rust / Cargo (for
smugglex) - GNU coreutils, getopt, sed (macOS only via Homebrew)
- ~5GB free disk space for Go cache, tools, and repos
- ~1GB RAM minimum (Go compilation)
Production (Docker):
- Base image:
ubuntu:24.04 - Build arg
INSTALL_AXIOM=true(default) installs axiom fleet tooling - Ports 85-90 exposed (for headless browser tooling)
- Runs as root (required for raw socket operations by some tools)
- Health check:
./reconftw.sh --health-check
Stack analysis: 2026-05-13