iulianvostrut/contexthoundCLI di analisi statica che scansiona i codebase per vulnerabilità di prompt injection nei LLM, esfiltrazione di dati, jailbreak e agent/strumenti non sicuri. Funziona completamente offline, si integra con CI/CD e produce report in console, JSON e SARIF.
Strumento di analisi statica che scansiona la tua codebase alla ricerca di vulnerabilità di prompt-injection LLM e di sicurezza multimodale. Funziona offline, non richiede chiamate API.
ContextHound è disponibile in tutto il tuo flusso di lavoro di sviluppo e navigazione:
| Strumento | Cosa fa | Installazione |
|---|---|---|
| CLI / pacchetto npm | Scansiona la tua codebase alla ricerca di vulnerabilità di prompt injection. Si integra con GitHub Actions, produce output SARIF, JSON, HTML e altro. | npm install -g context-hound |
| Estensione VS Code | Risultati inline mentre scrivi il codice, azioni sul codice, canale di output, barra di stato. | VS Code Marketplace |
| Estensione browser | Pillola di scansione in tempo reale su qualsiasi interfaccia di chat AI, pannello DevTools per il traffico API LLM, scanner popup. Chrome e Firefox. | Firefox: Installa gratis · Chrome: in attesa di revisione · sorgente |
Man mano che le applicazioni basate su LLM diventano comuni nelle codebase di produzione, il prompt injection è emerso come una delle superfici di attacco più sfruttabili; la maggior parte degli scanner di sicurezza non ne è a conoscenza.
ContextHound porta l'analisi statica nel tuo livello di prompt:
Si integra nel tuo flusso di lavoro esistente come comando CLI, script npm, hook pre-commit o GitHub Action. Non effettua chiamate di rete e ha quattro piccole dipendenze di runtime.
| 122 regole di sicurezza | Su 15 famiglie: injection, esfiltrazione, jailbreak, uso non sicuro di strumenti, command injection, avvelenamento RAG, codifica e contenuti nascosti, gestione dell'output, multimodale, competenze degli agenti, agentico, MCP, supply chain, consumo di risorse, persistenza |
| Mappatura OWASP | Ogni regola riporta gli ID OWASP Top 10 for LLM Applications (2025) e Agentic Applications (2026), mostrati in hound explain, --verbose, tag SARIF e tutti i report |
| Punteggio di rischio numerico (0-100) | Punteggio normalizzato a livello di repository con soglie bassa, media, alta e critica |
| Rilevamento delle mitigazioni | Linguaggio di sicurezza esplicito nei tuoi prompt riduce il tuo punteggio |
| 9 formati di output | Console, JSON, SARIF, GitHub Annotations, Markdown, streaming JSONL, HTML interattivo, CSV e JUnit XML |
| GitHub Action inclusa | Fa fallire la CI su modifiche rischiose, carica SARIF su Code Scanning e può mantenere un commento di riepilogo sulla pull request |
| Autofix | hound fix mostra in anteprima e rimuove i caratteri Unicode nascosti (ENC-002 a ENC-005) |
| Scansione multi-linguaggio | Rileva l'uso di API LLM in Python, Go, Rust, Java, C#, PHP, Ruby, Swift, Kotlin, Vue e Bash, non solo TypeScript e JavaScript |
| Filtro delle regole | excludeRules/includeRules con sintassi prefix-glob (CMD-*); filtro minConfidence |
| Cache incrementale | .hound-cache.json salta i file non modificati alle riesecuzioni; --no-cache per disabilitarla |
Rispetta .gitignore | I file ignorati da git vengono saltati; .houndignore aggiunge esclusioni con la stessa sintassi |
| Sistema di plugin | Carica regole personalizzate da file .js locali tramite "plugins": ["./my-rule.js"] nella configurazione |
| Modalità baseline / diff | --baseline results.json segnala e fallisce solo sui risultati assenti da una scansione precedente; --diff scansiona solo i file modificati |
| Modalità watch | --watch riesegue la scansione sulle modifiche dei file e mostra i risultati differenziali |
| Scansione parallela | Elaborazione concorrente dei file (--concurrency <n>, predefinito 8) |
| Completamente offline | Nessuna chiamata API e nessuna telemetria |
L'installazione globale aggiunge il comando hound al tuo PATH:
npm install -g context-hound
Installazione per progetto è limitata a un singolo repository e viene eseguita tramite npx hound o uno script npm:
npm install --save-dev context-hound
Senza installare, npx scarica ed esegue il pacchetto:
npx context-hound scan --dir .
# Scaffold a config file
hound init
# Scan your project
hound scan --dir ./my-ai-project
# Or via npm script (scans current directory)
npm run hound
# Verbose output, shows remediations and confidence levels
hound scan --verbose
# Fail the build on any critical finding
hound scan --fail-on critical
# Export JSON and SARIF reports
hound scan --format console,json,sarif --out results
# GitHub Annotations (for CI step summaries)
hound scan --format github-annotations
# Markdown report with findings tables
hound scan --format markdown --out report
# Stream findings as JSONL (one JSON object per line)
hound scan --format jsonl | jq '.severity'
# List all rules
hound scan --list-rules
# Explain a rule (or a rule family by prefix)
hound explain INJ-001
hound explain PST --format json
# Fast PR gate: scan only files changed vs. origin/main
hound scan --diff
# Interactive HTML report (self-contained, open in browser)
hound scan --format html --out report
# Re-scan on file changes
hound scan --watch
# Parallel scanning (default is 8; tune for your machine)
hound scan --concurrency 16
# Disable incremental cache for a clean run
hound scan --no-cache
# Also scan files that git ignores (skipped by default)
hound scan --no-gitignore
# Preview, then remove, hidden Unicode characters flagged by ENC-002 to ENC-005
hound fix
hound fix --write