convez.ai
Skill
allsmog

vuln-scout

allsmog/vuln-scout

Ver no GitHub
BomPluginScore · de 0 a 100

AI-powered whitebox penetration testing plugin for Claude Code. 9 languages, 22 skills, 7 autonomous agents. STRIDE threat modeling, OWASP 2025 coverage, polyglot monorepo support.

Instalação

$npx convez-ai allsmog/vuln-scout

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
26
Forks
5
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v3.0.0
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

VulnScout's stable promise is an offline quick scan, shared findings.json with stable keys and hotspot-aware findings, SARIF/Markdown/HTML/PR-comment/bundle reports, suppressions, and a CI fail-on gate. It writes audit-plan.md and review-ledger.json for reviewer-driven workflows and exposes structured Claude Code and Kuzushi surfaces.

For MCP hosts, VulnScout also ships a local stdio MCP server with scanner, report, artifact, and Joern CPG tools. See docs/mcp.md.

VulnScout runs scanner binaries and Joern CPGQL locally against the workspace you provide. The stable quick path uses bundled rules and does not require a remote service.

Prerequisites

  • Python 3.9 or newer
  • Semgrep for the stable quick scan profile
  • Claude Code for slash-command workflows
  • Optional deep analyzers: Joern, CodeQL, Slither, Trivy, Checkov
  • Optional code-intelligence sidecar: CodeGraph for symbol search, context, and affected-file analysis
python3 -m pip install semgrep

5-Minute Demo

  1. Install the runtime prerequisite:

    python3 -m pip install semgrep
    
  2. Validate the local runtime:

    python3 vuln-scout/scripts/doctor.py --strict
    
  3. Scan the bundled vulnerable app and render an HTML report:

    python3 vuln-scout/scripts/scan_orchestrator.py demo/vulnerable-app --profile quick --output /tmp/vuln-scout-demo.json
    python3 vuln-scout/scripts/report.py /tmp/vuln-scout-demo.json --format html --output report.html
    

Expected quick-profile result: four findings from bundled local rules.

SeverityFinding
highPython SQL injection
highPython command injection
mediumBrowser XSS
mediumExpress open redirect

Stable Promise

See feature maturity for the full stability matrix.

CapabilityStatus
Offline quick scan with bundled rulesStable
Shared findings.json schema and stable keysStable
SARIF, Markdown, HTML, and bundle reportsStable
Suppressions and CI --fail-on gateStable
Kuzushi structured tool surfaceStable
Joern, CodeQL, Slither, Trivy, Checkov deep analyzersBeta when installed
Auto-fix, PoC, and mutation workflowsExperimental

Install

Primary paths are documented in docs/install.md. The quickest product check is the demo above; after that, use the Claude Code plugin command path.

claude plugin install vuln-scout
claude --plugin-dir ./vuln-scout
npm install @kuzushi/vuln-scout

Canonical Workflows

WorkflowCommandGuide
Full audit/vuln-scout:full-auditFirst run
Verify finding/vuln-scout:verifyPR review
Report/vuln-scout:reportCI
Scope repo/vuln-scout:scopeFirst run
Diff review/vuln-scout:diffPR review

Commands (15 total)

CommandMaturityPurpose
/vuln-scout:scanbetaRun quick, deep, or audit scan profiles
/vuln-scout:mobile-auditbetaAudit decompiled Android targets (jadx_out + apktool_out merged)
/vuln-scout:threatsbetaBuild STRIDE threat models
/vuln-scout:sinksbetaFind dangerous functions and output sinks
/vuln-scout:tracebetaTrace source-to-sink data flow
/vuln-scout:propagatebetaFind related instances of a confirmed pattern
/vuln-scout:create-ruleexperimentalGenerate custom Semgrep rules
/vuln-scout:org-memory-compileexperimentalCompile human-reviewed org memory
/vuln-scout:mutateexperimentalMutation-test security controls
/vuln-scout:auto-fixexperimentalGenerate patches for verified findings

Feature Maturity

SurfaceStableBetaExperimental
Profilesquickdeep, auditcustom-rules
ReportsSARIF, Markdown, HTML, PR comment, bundlegenerated PoCsgenerated exploit harnesses
Workflowsfull-audit, verify, report, scope, diffscan, threats, sinks, trace, propagatecreate-rule, mutate, auto-fix

Kuzushi Integration

The npm package exports Kuzushi tools that return structured results:

{ ok, output, artifacts, maturity, toolName }

Kuzushi exposes the same 15 command names as the Claude plugin. Its structured schemas cover the common flags; advanced reviewer workflows still live in the Claude Code command prompts.

The report tool supports sarif, md, json, html, pr-comment, and bundle.

MCP Server

Use the bundled MCP server when an MCP host should call VulnScout directly:

python3 vuln-scout/scripts/mcp_server.py

The server exposes vulnscout_scan, vulnscout_report, vulnscout_create_cpg, vulnscout_joern_query, vulnscout_joern_discover, vulnscout_verify_findings, CodeGraph sidecar tools, vulnscout_read_artifact, and vulnscout_doctor. Joern and CodeGraph tools return structured unavailable states when their binaries or indexes are not installed, and report content is opt-in to keep MCP responses compact.

Project Structure

vuln-scout/
  .claude-plugin/plugin.json
  agents/
  commands/
  hooks/
  skills/
  references/
  scripts/

35 Auto-Activated Skills

The plugin ships 27 knowledge skills plus 5 task skills under vuln-scout/skills/tasks/.

Audit Artifacts

  • .claude/audit-plan.md captures scope, module priority, attack surfaces, and verification strategy.
  • .claude/review-ledger.json records adversarial review rounds and approvals.
  • .claude/findings.json follows vuln-scout/references/findings.schema.json.

Migration

Users upgrading from 3.x should read docs/migration-3.x-to-3.2.md. /whitebox-pentest:* aliases remain as deprecated shim files for one release and are shipped as a legacy plugin root.

License

MIT

Ver o original no GitHub

Bom para

Relacionados