iulianvostrut/contexthound
CLI de análisis estático que escanea bases de código en busca de inyección de prompts en LLM, exfiltración de datos, jailbreak y vulnerabilidades de agentes/herramientas inseguros. Se ejecuta completamente sin conexión, se integra con CI/CD y genera informes en consola, JSON y SARIF.
Herramienta de análisis estático que escanea tu base de código en busca de vulnerabilidades de inyección de prompts en LLM y de seguridad multimodal. Se ejecuta sin conexión, no requiere llamadas a API.
ContextHound está disponible en todo tu flujo de trabajo de desarrollo y navegación:
| Herramienta | Qué hace | Instalación |
|---|---|---|
| CLI / paquete npm | Escanea tu base de código en busca de vulnerabilidades de inyección de prompts. Se integra con GitHub Actions, genera SARIF, JSON, HTML y más. | npm install -g context-hound |
| Extensión de VS Code | Hallazgos en línea mientras programas, acciones de código, canal de salida, barra de estado. | VS Code Marketplace |
| Extensión de navegador | Píldora de escaneo en tiempo real en cualquier interfaz de chat con IA, panel de DevTools para tráfico de API de LLM, escáner emergente. Chrome y Firefox. | Firefox: Instalar gratis · Chrome: pendiente de revisión · código fuente |
A medida que las aplicaciones impulsadas por LLM se vuelven comunes en las bases de código de producción, la inyección de prompts ha surgido como una de las superficies de ataque más explotables; la mayoría de los escáneres de seguridad no son conscientes de ello.
ContextHound aporta análisis estático a tu capa de prompts:
Se integra en tu flujo de trabajo existente como un comando CLI, un script de npm, un hook de pre-commit o una GitHub Action. No realiza llamadas de red y tiene cuatro pequeñas dependencias en tiempo de ejecución.
| 122 reglas de seguridad | En 15 familias: inyección, exfiltración, jailbreak, uso inseguro de herramientas, inyección de comandos, envenenamiento RAG, codificación y contenido oculto, manejo de salida, multimodal, habilidades de agentes, agéntico, MCP, cadena de suministro, consumo de recursos, persistencia |
| Mapeo OWASP | Cada regla incluye IDs de OWASP Top 10 para Aplicaciones LLM (2025) y Aplicaciones Agénticas (2026), mostrados en hound explain, --verbose, etiquetas SARIF y todos los informes |
| Puntuación de riesgo numérica (0-100) | Puntuación normalizada a nivel de repositorio con umbrales bajo, medio, alto y crítico |
| Detección de mitigaciones | El lenguaje de seguridad explícito en tus prompts reduce tu puntuación |
| 9 formatos de salida | Consola, JSON, SARIF, GitHub Annotations, Markdown, streaming JSONL, HTML interactivo, CSV y JUnit XML |
| GitHub Action incluida | Falla la CI ante cambios riesgosos, sube SARIF a Code Scanning y puede mantener un comentario de resumen en el pull request |
| Autofix | hound fix previsualiza y elimina caracteres Unicode ocultos (ENC-002 a ENC-005) |
| Escaneo multilenguaje | Detecta uso de API de LLM en Python, Go, Rust, Java, C#, PHP, Ruby, Swift, Kotlin, Vue y Bash, no solo en TypeScript y JavaScript |
| Filtrado de reglas | excludeRules/includeRules con sintaxis de prefijo-glob (CMD-*); filtro minConfidence |
| Caché incremental | .hound-cache.json omite archivos sin cambios en reejecuciones; --no-cache para deshabilitar |
Respeta .gitignore | Los archivos que git ignora se omiten; .houndignore añade exclusiones con la misma sintaxis |
| Sistema de plugins | Carga reglas personalizadas desde archivos .js locales mediante "plugins": ["./my-rule.js"] en la configuración |
| Modo baseline / diff | --baseline results.json informa y falla solo ante hallazgos ausentes en un escaneo previo; --diff escanea solo los archivos modificados |
| Modo watch | --watch reescanea ante cambios en archivos y muestra los hallazgos delta |
| Escaneo paralelo | Procesamiento concurrente de archivos (--concurrency <n>, por defecto 8) |
| Totalmente sin conexión | Sin llamadas a API y sin telemetría |
La instalación global añade el comando hound a tu PATH:
npm install -g context-hound
Instalación por proyecto está limitada a un solo repositorio y se ejecuta mediante npx hound o un script de npm:
npm install --save-dev context-hound
Sin instalar, npx obtiene y ejecuta el paquete:
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