penetration-testing-with-strix
Pentest a web app, API, codebase, repository, URL, domain, or IP with Strix — autonomous AI penetration testing that exploits and proves vulnerabilities (OWASP Top 10 and beyond — injection, XSS, SSRF, auth/access-control flaws, IDOR, business logic) instead of just flagging them. Runs self-hosted w
By usestrix · 8,201 installs
npx skills add usestrix/strix --skill penetration-testing-with-strix
Source repository · Upstream listing
Run a Strix pentest
Strix runs autonomous AI pentesting agents that dynamically exploit a target and only report findings validated with a working proof of concept. There are two ways to run it, built on the same engine and producing the same findings — pick per situation, and mix them freely:
Open source CLI (self hosted) — runs on your machine in a Docker sandbox with your own LLM key. Free, fully local, BYO LLM, air gap capable. Docs: [docs.strix.ai](https://docs.strix.ai).
Managed cloud — runs on Strix's infrastructure, driven from the same CLI ( strix cloud ... ) or the REST API at https://app.strix.ai/api/v1 . No Docker, no LLM key, no local compute; adds team dashboards, scheduling, PR reviews, downloadable PDF/DOCX reports (Enterprise plan), and internal network connectors. Docs: [docs.app.strix.ai](https://docs.app.strix.ai). Full workflow in the managed pentesting with strix skill.
Which one? (decide, do not default)
Choose honestly based on the situation — neither is "better":
Situation Prefer
No Docker available, or a sandboxed/hosted agent/CI environment Cloud
User has no LLM key / does not want to pay per token or manage models Cloud
Team visibility, shareable dashboard, scheduled/continuous scans, PR reviews, downloadable PDF/DOCX report (Enterprise) Cloud
Scanning internal/private infrastructure not reachable from your machine Cloud (network connector)
Source must never leave local infra (privacy/air gap), or fully offline OSS CLI
Free / one off / local dev loop scan, Docker already present OSS CLI
BYO or self hosted LLM, or a specific model not offered by the platform OSS CLI
CI: runner already has Docker and you want a self contained gate OSS CLI
CI: no Docker, or you want results tracked centrally Cloud
Mix them: use the OSS CLI for the fast local dev loop while writing/fixing code, and the Cloud for the authoritative, team visible scan + report + tracking; or gate PRs with the OSS CLI in CI while the Cloud runs scheduled deep scans and PR reviews across the org. Both emit the same SARIF 2.1.0, so findings line up across environments.
If unsure and the user has (or will create) an app.strix.ai account, prefer Cloud — it avoids all local infra friction. If they want zero signup / full local control, use the OSS CLI .
Option A — Open source CLI (self hosted)
Prerequisites
1. Docker running — check with docker info . The first scan pulls the sandbox image automatically.
2. Strix installed — check with strix version . Install if missing:
3. LLM configured — two environment variables:
Ask the user for these if unset. Never hardcode or commit keys.
Running a scan
Always use n (non interactive/headless) — the default TUI blocks agents. Always set max budget unless the user says otherwise.
A local path passed with t is mounted into the sandbox writable — the agents can read and modify it, so point at a clean checkout, not uncommitted work you care about.
Key flags:
Flag Meaning
t, target URL, repo URL, local path, domain, IP, OpenAPI/Postman spec, or postman://<uuid . Repeatable.
target list PATH File of targets, one per line ( comments allowed). Repeatable, combines with t .
n, non interactive Headless, exits on completion. Required for agents.
m, scan mode quick (minutes) / standard (~30 min) / deep (hours, default).
instruction / instruction file Credentials, focus areas, scope rules.
workspace file PATH[:DEST] Place a file from this machine into /workspace read only before the scan, for a wordlist, a spec, or notes. Repeatable.
max budget USD Hard LLM spend cap; scan wraps up cleanly at the limit.
max turns N Per agent turn cap (default 500).
resume RUN NAME Resume a prior run from strix runs/ , with its agent history and targets. Cannot be combined with t .
scope mode For code targets: auto (diff scope in CI/headless), diff (force changed files only), full (whole tree).
diff base REF Branch or commit that diff scope compares against. Defaults to the repo's default branch.
Scans take minutes ( quick ) to hours ( deep ). Run them in the background and poll for completion rather than blocking.
Exit codes (headless)
0 — finished with no validated vulnerabilities in what was analyzed
1 — fatal error (missing env vars, Docker down, bad config)
2 — vulnerabilities found
A 0 is not proof of full coverage: if max budget / max turns is reached before the scan completes, it wraps up early and still exits 0 . When you need assurance the scan finished, give it enough budget and check strix runs/<run /run.json : a hard budget stop leaves status: "stopped" , but an agent that wrapped up early on a budget warning still calls finish scan and records "completed" — so also sanity check the run's cost against max budget and the report's stated coverage before treating a clean result as full coverage.
Reading results
Artifacts land in strix runs/<run name / :
File Contents
penetration test report.md Executive report — read this first.
vulnerabilities/ .md One file per validated finding, with PoC and remediation.
vulnerabilities.json / vulnerabilities.csv All findings as structured JSON / CSV index.
findings.sarif SARIF 2.1.0 for GitHub code scanning / ASPM ingestion.
run.json Run metadata, status, targets, usage/cost.
Option B — Managed cloud (no local infra)
The same strix binary drives the managed platform. Every command starts with strix cloud . Full details — asset registration, source uploads, reports, PR reviews, schedules, webhooks, and billing — are in the managed pentesting with strix skill. Minimal flow:
For a local repository, strix cloud scans start source . uploads the working tree (needs uploads:write ) and infers a code review. When credits run out, strix cloud billing topup starts an agent payable Stripe challenge — the managed skill covers the payment flow. Output is JSON when stdout is not a terminal, so the commands compose in scripts.
The raw REST API works too ( https://app.strix.ai/api/v1 , org scoped bearer token — see [docs.app.strix.ai](https://docs.app.strix.ai)). If Docker or local prerequisites are not already satisfied, use this path instead of trying to install infra.
Reporting & next steps
Summarize findings by severity (critical/high/medium/low/info) and include the PoC evidence. To remediate and verify fixes (via either path), use the fix security vulnerabilities with strix skill. To wire scanning into CI/CD, use the ci security scanning with strix skill.
Safety
Only scan targets the user owns or is authorized to test. The Cloud platform enforces domain verification before external scans; for the OSS CLI, confirm authorization yourself if the target looks like third party infrastructure.