ContextHound

Ferramenta de análise estática que examina sua base de código em busca de vulnerabilidades de prompt-injection em LLMs e de segurança multimodal. Funciona offline, sem necessidade de chamadas de API.

---

O ecossistema ContextHound

O ContextHound está disponível em todo o seu fluxo de desenvolvimento e navegação:

Ferramenta	O que faz	Instalação
CLI / pacote npm	Examina sua base de código em busca de vulnerabilidades de prompt injection. Integra-se ao GitHub Actions, gera saídas SARIF, JSON, HTML e mais.	npm install -g context-hound
Extensão VS Code	Achados inline enquanto você programa, ações de código, canal de saída, barra de status.	VS Code Marketplace
Extensão de navegador	Pílula de varredura em tempo real em qualquer interface de chat com IA, painel DevTools para tráfego de API de LLM, scanner em popup. Chrome e Firefox.	Firefox: Instalar grátis · Chrome: aguardando revisão · código-fonte

---

☕ Apoie o projeto

---

Por que o ContextHound?

À medida que aplicações baseadas em LLM se tornam comuns em bases de código de produção, o prompt injection emergiu como uma das superfícies de ataque mais exploráveis; a maioria dos scanners de segurança não tem consciência disso.

O ContextHound traz análise estática para a sua camada de prompts:

• Detecta caminhos de injeção antes que cheguem a um modelo
• Sinaliza credenciais vazadas e infraestrutura interna embutidas em prompts
• Detecta formulações suscetíveis a jailbreak nos seus system prompts
• Identifica uso irrestrito de ferramentas agênticas que poderia ser weaponizado
• Detecta envenenamento de corpus RAG e conteúdo recuperado injetado como instruções de sistema
• Detecta contrabando baseado em codificação (instruções em Base64 que contornam filtros de string)
• Sinaliza consumo inseguro de saída de LLM: JSON sem validação de schema e Markdown sem sanitização
• Detecta superfícies de ataque multimodais: URLs de imagens fornecidas pelo usuário para APIs de visão, path traversal via leitura de arquivos em mensagens de visão, saída de transcrição alimentando prompts e texto de OCR injetado em instruções de sistema
• Sinaliza riscos agênticos: loops de agente sem limite, gravações de memória não validadas, injeção de plano e parâmetros de ferramentas recebendo conteúdo de system-prompt
• Recompensa boas práticas de segurança: mitigações nos seus prompts reduzem sua pontuação

Ele se encaixa no seu fluxo de trabalho existente como um comando CLI, um script npm, um hook de pre-commit ou uma GitHub Action. Não faz chamadas de rede e tem quatro pequenas dependências de runtime.

---

Recursos

122 regras de segurança	Em 15 famílias: injection, exfiltration, jailbreak, unsafe tool use, command injection, RAG poisoning, encoding and hidden content, output handling, multimodal, agent skills, agentic, MCP, supply chain, resource consumption, persistence
Mapeamento OWASP	Cada regra carrega IDs do OWASP Top 10 for LLM Applications (2025) e Agentic Applications (2026), exibidos em hound explain, --verbose, tags SARIF e todos os relatórios
Pontuação de risco numérica (0-100)	Pontuação normalizada em nível de repositório com limiares low, medium, high e critical
Detecção de mitigações	Linguagem de segurança explícita nos seus prompts reduz sua pontuação
9 formatos de saída	Console, JSON, SARIF, GitHub Annotations, Markdown, streaming JSONL, HTML interativo, CSV e JUnit XML
GitHub Action incluída	Falha o CI em mudanças arriscadas, envia SARIF para Code Scanning e pode manter um comentário de resumo no pull request
Autofix	hound fix pré-visualiza e remove caracteres Unicode ocultos (ENC-002 a ENC-005)
Varredura multilíngue	Detecta uso de API de LLM em Python, Go, Rust, Java, C#, PHP, Ruby, Swift, Kotlin, Vue e Bash, não apenas TypeScript e JavaScript
Filtragem de regras	excludeRules/includeRules com sintaxe prefix-glob (CMD-*); filtro minConfidence
Cache incremental	.hound-cache.json pula arquivos inalterados em re-execuções; --no-cache para desabilitar
Respeita .gitignore	Arquivos ignorados pelo git são pulados; .houndignore adiciona exclusões na mesma sintaxe
Sistema de plugins	Carregue regras personalizadas de arquivos .js locais via "plugins": ["./my-rule.js"] na configuração
Modo baseline / diff	--baseline results.json reporta e falha apenas em achados ausentes de uma varredura anterior; --diff varre apenas arquivos alterados
Modo watch	--watch re-varre em mudanças de arquivo e mostra achados delta
Varredura paralela	Processamento concorrente de arquivos (--concurrency <n>, padrão 8)
Totalmente offline	Sem chamadas de API e sem telemetria

---

Instalação

Instalação global adiciona o comando hound ao seu PATH:

npm install -g context-hound

Instalação por projeto é limitada a um repositório e é executada via npx hound ou um script npm:

npm install --save-dev context-hound

Sem instalar, o npx busca e executa o pacote:

npx context-hound scan --dir .

Início Rápido

# 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

# Baseline mode: only report findings new since the last saved scan
hound scan --format json --out baseline          # save a baseline
hound scan --baseline baseline.json             # compare future scans against it