A CLI built from day one for headless, agent-driven environments. Authenticate once and let your agent run the entire penetration test lifecycle.
01
Authenticate
Store a token via environment variable or the device auth flow.
02
Create a project
Point at a web app, API, network, or cloud account.
03
Launch scans
Start, pause, resume, cancel, or schedule scans and poll for status.
04
Triage findings
List vulnerabilities, inspect evidence, mark false positives, or kick off retests.
05
Generate reports
Produce executive, technical, or compliance PDFs.
06
Track usage
Estimate ops cost before scanning and verify budget availability.
# Full autonomous workflow
export REDVEIL_TOKEN="$REDVEIL_SECRET"
PROJECT=$(pentest-agent project create webapp \
--name "Acme App" \
--target https://app.acme.com \
--auth-type bearer \
--bearer-token @/secrets/bearer.txt \
--json)
PROJECT_ID=$(echo "$PROJECT" | jq -r '._id')
pentest-agent scan start "$PROJECT_ID"
pentest-agent scan status "$PROJECT_ID" --json
pentest-agent finding list "$PROJECT_ID" --json
pentest-agent report generate --project "$PROJECT_ID" --type executive_pdf --json
Every response is parseable JSON. An agent can inspect each result, decide what to do next, and keep going — no human in the loop.