iulianvostrut/contexthoundStatische Analyse-CLI, die Codebasen auf LLM-Prompt-Injection, Datenextraktion, Jailbreak und unsichere Agenten-/Tool-Schwachstellen scannt. Läuft vollständig offline, integriert sich in CI/CD und gibt Konsolen-, JSON- und SARIF-Berichte aus.
Statisches Analysetool, das deine Codebasis auf LLM-Prompt-Injection- und multimodale Sicherheitslücken scannt. Läuft offline, keine API-Aufrufe erforderlich.
ContextHound ist über deinen gesamten Entwicklungs- und Browser-Workflow hinweg verfügbar:
| Tool | Was es tut | Installation |
|---|---|---|
| CLI / npm-Paket | Scannt deine Codebasis auf Prompt-Injection-Schwachstellen. Integriert sich in GitHub Actions, gibt SARIF, JSON, HTML und mehr aus. | npm install -g context-hound |
| VS Code-Erweiterung | Inline-Befunde während des Codierens, Code Actions, Ausgabekanal, Statusleiste. | VS Code Marketplace |
| Browser-Erweiterung | Echtzeit-Scan-Pille auf jeder KI-Chat-Oberfläche, DevTools-Panel für LLM-API-Verkehr, Popup-Scanner. Chrome und Firefox. | Firefox: Kostenlos installieren · Chrome: Überprüfung ausstehend · Quellcode |
Da LLM-gestützte Anwendungen in Produktions-Codebasen immer häufiger werden, hat sich Prompt-Injection als eine der am besten ausnutzbaren Angriffsflächen herauskristallisiert; die meisten Sicherheitsscanner haben keinerlei Bewusstsein dafür.
ContextHound bringt statische Analyse in deine Prompt-Ebene:
Es fügt sich in deinen bestehenden Workflow ein als CLI-Befehl, ein npm-Skript, ein Pre-Commit-Hook oder eine GitHub Action. Es führt keine Netzwerkaufrufe durch und hat vier kleine Laufzeitabhängigkeiten.
| 122 Sicherheitsregeln | Über 15 Familien hinweg: Injection, Exfiltration, Jailbreak, unsichere Tool-Nutzung, Command Injection, RAG-Vergiftung, Encoding und versteckte Inhalte, Ausgabeverarbeitung, multimodal, Agent Skills, agentisch, MCP, Supply Chain, Ressourcenverbrauch, Persistenz |
| OWASP-Zuordnung | Jede Regel trägt OWASP Top 10 for LLM Applications (2025) und Agentic Applications (2026) IDs, angezeigt in hound explain, --verbose, SARIF-Tags und allen Berichten |
| Numerischer Risiko-Score (0-100) | Normalisierter Score auf Repo-Ebene mit Schwellenwerten für niedrig, mittel, hoch und kritisch |
| Mitigation-Erkennung | Explizite Sicherheitssprache in deinen Prompts reduziert deinen Score |
| 9 Ausgabeformate | Konsole, JSON, SARIF, GitHub Annotations, Markdown, JSONL-Streaming, interaktives HTML, CSV und JUnit XML |
| GitHub Action enthalten | Lässt CI bei riskanten Änderungen fehlschlagen, lädt SARIF zu Code Scanning hoch und kann einen Zusammenfassungskommentar am Pull Request hinterlassen |
| Autofix | hound fix zeigt eine Vorschau an und entfernt versteckte Unicode-Zeichen (ENC-002 bis ENC-005) |
| Mehrsprachiges Scannen | Erkennt LLM-API-Nutzung in Python, Go, Rust, Java, C#, PHP, Ruby, Swift, Kotlin, Vue und Bash, nicht nur in TypeScript und JavaScript |
| Regelfilterung | excludeRules/includeRules mit Präfix-Glob-Syntax (CMD-*); minConfidence-Filter |
| Inkrementeller Cache | .hound-cache.json überspringt unveränderte Dateien bei erneuten Läufen; --no-cache zum Deaktivieren |
Respektiert .gitignore | Von Git ignorierte Dateien werden übersprungen; .houndignore fügt Ausschlüsse in derselben Syntax hinzu |
| Plugin-System | Lade benutzerdefinierte Regeln aus lokalen .js-Dateien über "plugins": ["./my-rule.js"] in der Konfiguration |
| Baseline-/Diff-Modus | --baseline results.json meldet und schlägt nur bei Befunden fehl, die in einem vorherigen Scan fehlten; --diff scannt nur geänderte Dateien |
| Watch-Modus | --watch scannt bei Dateiänderungen erneut und zeigt Delta-Befunde an |
| Paralleles Scannen | Gleichzeitige Dateiverarbeitung (--concurrency <n>, Standard 8) |
| Vollständig offline | Keine API-Aufrufe und keine Telemetrie |
Globale Installation fügt den hound-Befehl zu deinem PATH hinzu:
npm install -g context-hound
Installation pro Projekt ist auf ein Repository beschränkt und wird über npx hound oder ein npm-Skript ausgeführt:
npm install --save-dev context-hound
Ohne Installation lädt npx das Paket herunter und führt es aus:
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