iulianvostrut/contexthound
CLI d'analyse statique qui scanne les bases de code pour les injections de prompt LLM, les exfiltrations de données, les jailbreaks et les vulnérabilités liées aux agents/outils non sécurisés. Fonctionne entièrement hors ligne, s'intègre au CI/CD et produit des rapports console, JSON et SARIF.
Outil d'analyse statique qui scanne votre base de code à la recherche de vulnérabilités de prompt-injection LLM et de sécurité multimodale. Fonctionne hors ligne, aucune API requise.
ContextHound est disponible sur l'ensemble de votre flux de développement et de navigation :
| Outil | Ce qu'il fait | Installation |
|---|---|---|
| CLI / package npm | Scanne votre base de code à la recherche de vulnérabilités de prompt injection. S'intègre à GitHub Actions, produit du SARIF, JSON, HTML, et plus encore. | npm install -g context-hound |
| Extension VS Code | Résultats en ligne pendant que vous codez, actions de code, canal de sortie, barre d'état. | VS Code Marketplace |
| Extension navigateur | Pastille de scan en temps réel sur toute interface de chat IA, panneau DevTools pour le trafic API LLM, scanner en popup. Chrome et Firefox. | Firefox : Installer gratuitement · Chrome : en attente de validation · source |
À mesure que les applications propulsées par des LLM deviennent courantes dans les bases de code de production, la prompt injection est apparue comme l'une des surfaces d'attaque les plus exploitables ; la plupart des scanners de sécurité n'en ont aucune conscience.
ContextHound apporte l'analyse statique à votre couche de prompts :
Il s'intègre à votre flux de travail existant en tant que commande CLI, script npm, hook pre-commit ou GitHub Action. Il n'effectue aucun appel réseau et possède quatre petites dépendances d'exécution.
| 122 règles de sécurité | Réparties sur 15 familles : injection, exfiltration, jailbreak, utilisation d'outils non sécurisée, injection de commandes, empoisonnement RAG, encodage et contenu caché, traitement des sorties, multimodal, compétences d'agent, agentique, MCP, chaîne d'approvisionnement, consommation de ressources, persistance |
| Mapping OWASP | Chaque règle porte les identifiants OWASP Top 10 for LLM Applications (2025) et Agentic Applications (2026), affichés dans hound explain, --verbose, les tags SARIF et tous les rapports |
| Score de risque numérique (0-100) | Score normalisé au niveau du dépôt avec seuils faible, moyen, élevé et critique |
| Détection de mitigations | Un langage de sécurité explicite dans vos prompts réduit votre score |
| 9 formats de sortie | Console, JSON, SARIF, GitHub Annotations, Markdown, streaming JSONL, HTML interactif, CSV et JUnit XML |
| GitHub Action inclus | Fait échouer la CI sur les changements risqués, téléverse le SARIF vers Code Scanning et peut maintenir un commentaire de résumé sur la pull request |
| Autofix | hound fix prévisualise et supprime les caractères Unicode cachés (ENC-002 à ENC-005) |
| Scan multi-langages | Détecte l'utilisation d'API LLM en Python, Go, Rust, Java, C#, PHP, Ruby, Swift, Kotlin, Vue et Bash, pas seulement TypeScript et JavaScript |
| Filtrage de règles | excludeRules/includeRules avec syntaxe prefix-glob (CMD-*) ; filtre minConfidence |
| Cache incrémental | .hound-cache.json ignore les fichiers inchangés lors des réexécutions ; --no-cache pour désactiver |
Respecte .gitignore | Les fichiers ignorés par git sont sautés ; .houndignore ajoute des exclusions avec la même syntaxe |
| Système de plugins | Chargez des règles personnalisées depuis des fichiers .js locaux via "plugins": ["./my-rule.js"] dans la config |
| Mode baseline / diff | --baseline results.json ne rapporte et n'échoue que sur les résultats absents d'un scan antérieur ; --diff ne scanne que les fichiers modifiés |
| Mode watch | --watch relance le scan sur les changements de fichiers et affiche les résultats différentiels |
| Scan parallèle | Traitement concurrent des fichiers (--concurrency <n>, par défaut 8) |
| Entièrement hors ligne | Aucun appel API et aucune télémétrie |
L'installation globale ajoute la commande hound à votre PATH :
npm install -g context-hound
Installation par projet est limitée à un seul dépôt et s'exécute via npx hound ou un script npm :
npm install --save-dev context-hound
Sans installation, npx récupère et exécute le paquet :
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