iulianvostrut/contexthoundCLI статического анализа, который сканирует кодовые базы на наличие LLM prompt-injection, data-exfiltration, jailbreak и unsafe agent/tool vulnerabilities. Работает полностью офлайн, интегрируется с CI/CD и выводит отчеты в консоль, JSON и SARIF.
Инструмент статического анализа, который сканирует вашу кодовую базу на предмет уязвимостей, связанных с LLM prompt-injection и мультимодальной безопасностью. Работает офлайн, без API-вызовов.
ContextHound доступен на протяжении всего вашего рабочего процесса разработки и работы в браузере:
| Инструмент | Что он делает | Установка |
|---|---|---|
| CLI / npm-пакет | Сканирует вашу кодовую базу на предмет уязвимостей prompt injection. Интегрируется с GitHub Actions, выводит SARIF, JSON, HTML и другое. | npm install -g context-hound |
| Расширение для VS Code | Встроенные результаты по мере написания кода, действия с кодом, канал вывода, строка состояния. | VS Code Marketplace |
| Расширение для браузера | Индикатор сканирования в реальном времени на любом интерфейсе AI-чата, панель DevTools для трафика LLM API, сканер во всплывающем окне. Chrome и Firefox. | Firefox: Установить бесплатно · Chrome: ожидает проверки · исходный код |
Поскольку приложения на основе LLM становятся обычным явлением в production-кодовых базах, prompt injection превратился в одну из наиболее эксплуатируемых поверхностей атак; большинство сканеров безопасности вообще не подозревают о его существовании.
ContextHound привносит статический анализ в ваш слой промптов:
Он встраивается в ваш существующий рабочий процесс как команда CLI, npm-скрипт, pre-commit hook или GitHub Action. Он не выполняет сетевых вызовов и имеет четыре небольшие runtime-зависимости.
| 122 правила безопасности | По 15 семействам: 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 |
| Сопоставление с OWASP | Каждое правило несёт идентификаторы OWASP Top 10 for LLM Applications (2025) и Agentic Applications (2026), отображаемые в hound explain, --verbose, тегах SARIF и всех отчётах |
| Числовой риск-балл (0-100) | Нормализованный балл уровня репозитория с порогами low, medium, high и critical |
| Обнаружение мер защиты | Явные формулировки о безопасности в ваших промптах снижают ваш балл |
| 9 форматов вывода | Console, JSON, SARIF, GitHub Annotations, Markdown, JSONL streaming, интерактивный HTML, CSV и JUnit XML |
| Включён GitHub Action | Проваливает CI при рискованных изменениях, загружает SARIF в Code Scanning и может оставлять сводный комментарий в pull request |
| Автоисправление | hound fix показывает предпросмотр и удаляет скрытые символы Unicode (ENC-002 — ENC-005) |
| Многоязычное сканирование | Обнаруживает использование LLM API в Python, Go, Rust, Java, C#, PHP, Ruby, Swift, Kotlin, Vue и Bash, а не только в TypeScript и JavaScript |
| Фильтрация правил | excludeRules/includeRules с синтаксисом prefix-glob (CMD-*); фильтр minConfidence |
| Инкрементальный кэш | .hound-cache.json пропускает неизменённые файлы при повторных запусках; --no-cache для отключения |
Учитывает .gitignore | Файлы, игнорируемые git, пропускаются; .houndignore добавляет исключения в том же синтаксисе |
| Система плагинов | Загружайте пользовательские правила из локальных .js-файлов через "plugins": ["./my-rule.js"] в конфиге |
| Режим baseline / diff | --baseline results.json сообщает и проваливает только по находкам, отсутствовавшим в предыдущем сканировании; --diff сканирует только изменённые файлы |
| Режим наблюдения | --watch повторно сканирует при изменениях файлов и показывает дельта-находки |
| Параллельное сканирование | Конкурентная обработка файлов (--concurrency <n>, по умолчанию 8) |
| Полностью офлайн | Никаких API-вызовов и никакой телеметрии |
Глобальная установка добавляет команду hound в ваш PATH:
npm install -g context-hound
Установка для отдельного проекта ограничена одним репозиторием и запускается через npx hound или npm-скрипт:
npm install --save-dev context-hound
Без установки npx загружает и запускает пакет:
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