auger
Load test, discover and inspect HTTP endpoints from the terminal.
Four commands, one binary:
auger run— hammer a URL with concurrent requests, get percentiles, a latency histogram and a flamegraphauger scan— brute-force endpoints with a wordlistauger check— inspect status, HTTP version and security headers with an A-F gradeauger cert— show the TLS certificate for a host
install
From crates.io:
cargo install auger
Or the install script (downloads the latest prebuilt binary):
curl -fsSL https://raw.githubusercontent.com/user123cy/auger/main/scripts/install.sh | bash
Prebuilt binaries for Linux, macOS and Windows are attached to every release.
load test
auger run https://api.example.com/ # 20 workers, 5s
auger run https://api.example.com/ -c 200 -d 30s # 200 workers, 30s
auger run https://api.example.com/ -m POST -d 10s
auger run https://api.example.com/ --random-ua -H "X-Token: abc"
auger run https://api.example.com/ -m POST --body '{"user":1}' # inline request body
auger run https://api.example.com/ -d 30s --quiet # no progress line
auger run https://api.example.com/ -d 30s --json # machine-readable output
Save a baseline and compare against it later:
auger run https://api.example.com/ -d 30s -s baseline.json
auger run https://api.example.com/ -d 30s --compare baseline.json --threshold 1.2
Any percentile slower than the baseline by more than the threshold flags a regression.
discover
auger scan https://example.com/ -w wordlist.txt # find non-404 paths
auger scan https://example.com/ -w wordlist.txt -e php,html # also try .php and .html
auger scan https://example.com/ -w wordlist.txt -o hits.txt # save status + url lines
auger scan https://example.com/ -w wordlist.txt -R # also probe robots.txt + sitemap.xml paths
auger scan https://example.com/ -w wordlist.txt --json # machine-readable output
inspect
auger check https://example.com/
auger check https://example.com/ --json
Shows status, HTTP version, server and which security headers are present: HSTS, CSP, clickjacking, mime sniffing, referrer, permissions, COOP, CORP. The headers are weighted and scored into a letter grade (A-F) in the style of securityheaders.com. Missing headers show the exact header line to add.
certificate
auger cert example.com
auger cert example.com:8443
auger cert https://example.com/ --json
Shows the subject, issuer, TLS version, key size, signature algorithm, chain length, validity dates, days left and SANs. Exits non-zero when the certificate is expired and warns on stderr when it expires within 30 days.
reports
auger run https://api.example.com/ -d 10s -s report.json
auger report report.json # print it again later
auger report report.json --markdown # as a markdown table
auger html report.json -o r.html # self-contained HTML with a chart
auger compare before.json after.json
example
auger https://api.example.com/
20 workers · 5s · 12,403 req · 2,481 req/s
0 errors · 12.4 MB downloaded
percentiles (ms)
p50 12
p75 18
p90 26
p95 34
p99 52
max 190
latency histogram (ms)
1–5 ██████████ 1040
5–9 ██████████ 1078
9–13 ██████████ 1111
13–26 █████████ 976
26–52 ██████ 621
52–190 █████ 530
why
Most load testers are huge — a config file, a GUI or a whole platform just to measure a couple of endpoints. auger is one binary, a few flags and a fast release build.
license
MIT