| name | pentest |
| description | Security scanning via clearwing — source code vulnerability hunting and network pentesting.
|
| allowed-tools | ["Bash","Read","Write","Grep","Glob"] |
Pentest — Clearwing Security Scanner
Authorized security testing using clearwing.
Authorization Check
Before any scanning, confirm authorization with the user. Ask:
- Is this target owned by you or your organization?
- Do you have written authorization to test it?
- What is the scope (source code only, network, or both)?
If authorization is unclear, STOP and do not proceed.
Prerequisites
Check if clearwing is installed:
command -v clearwing && clearwing --version
If not installed:
uv tool install clearwing
clearwing setup
Requires: Python 3.10+, uv, Rust toolchain (for native bridge).
Mode 1: Source Code Analysis
Hunt vulnerabilities in source code using the 11-stage pipeline:
clearwing sourcehunt <path-to-repo> --depth standard
clearwing sourcehunt <path-to-repo> --depth quick
clearwing sourcehunt <path-to-repo> --depth deep
The pipeline: preprocess → rank files → generate fuzzing harnesses → tiered hunt (6 specialists) → adversarial verification → patch oracle → variant loop → exploit triage → auto-patch → report.
Evidence levels (ascending confidence):
suspicion — pattern match, needs investigation
static_corroboration — confirmed by static analysis
crash_reproduced — fuzzer triggered a crash
root_cause_explained — mechanism understood
exploit_demonstrated — exploitability confirmed
patch_validated — fix verified
Mode 2: Network Scanning
Scan a live target for service vulnerabilities:
clearwing scan <target-ip-or-hostname>
clearwing parallel <CIDR> --max-concurrent 5
Output
Results are stored in SQLite and exported as:
- SARIF — for GitHub Code Scanning integration
- Markdown — human-readable report
- JSON — machine-readable findings
Interactive Mode
For guided exploration:
clearwing interactive
clearwing interactive --resume <session_id>
CI Integration
clearwing ci --sarif-output results.sarif