Aguara CLI
Локальный сканер проверяет зависимости, инструкции агентов и настройки MCP до установки: вредоносные пакеты и опасные права.
- 94 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Читает файлы проекта и конфигурации MCP-клиентов на машине, в отчетах могут оказаться чувствительные фрагменты.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/garagon/aguara/v0.28.0/install.sh | VERSION=v0.28.0 shУстановщик сверяет контрольную сумму архива; бинарник попадает в `~/.local/bin`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает файлы проекта и конфигурации MCP-клиентов на машине, в отчетах могут оказаться чувствительные фрагменты.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Aguara проверяет то, что проект приносит в окружение: зависимости, инструкции агентов, настройки инструментов. Команда `aguara audit .` объединяет проверку известных вредоносных пакетов по lock-файлам и сканирование содержимого. Пакеты при этом не устанавливаются, команды проекта не запускаются. Скан охватывает скиллы и инструкции на внедрение промптов и подозрительные запросы секретов, конфигурации MCP, настройки Claude Code в `.claude/settings.json`, политики npm и pnpm, install-хуки и угрозы в GitHub Actions. Анализ идет локально, без телеметрии и вызовов LLM. Вывод: терминал, JSON, SARIF и Markdown.
Для кого. Разработчику и инженеру безопасности, которые перед установкой чужого репозитория или скилла хотят увидеть угрозы в зависимостях и настройках агента.
Подходит, если
- Перед `npm install` в незнакомом репозитории нужна проверка lock-файлов.
- Чужой скилл или `AGENTS.md` подозрительно просит прочитать секреты.
- В `.claude/settings.json` стоит `Bash(*)`, и надо понять, нужен ли такой доступ.
- В CI нужен барьер `aguara audit . --ci` перед установкой зависимостей.
Не подходит, если
- Нужен полный анализ CVE: инструмент находит вредоносные пакеты, а не уязвимости в целом.
- Нужна защита во время работы агента: Aguara не изолирует процессы и не перехватывает вызовы.
- Чистый отчет собираются считать сертификатом безопасности.
Пример запроса к агенту
Проверь этот репозиторий через `aguara audit .` и объясни находки с наивысшей серьезностью.Ограничения
Чистый отчет не гарантирует безопасность: неподдерживаемые форматы, динамический код и новые угрозы остаются за кадром. Версия 0.28.0 по умолчанию игнорирует исключения и подавления из самого проверяемого репозитория, а локальный `scan` их учитывает, поэтому для незнакомых проектов нужен `--project-policy ignore`. Бинарный `bun.lockb` не разбирается, нужен текстовый `bun.lock`. Охват пакетных систем зависит от того, что записывает lock-файл и что знает снимок базы угроз.
Как отключить. Удалите бинарник `aguara` из `~/.local/bin` (или `brew uninstall aguara`) и уберите шаг `aguara audit . --ci` из конфигурации CI.
Частые вопросы
Как проверить репозиторий или скилл перед установкой?
Выполните `aguara audit .` в каталоге проекта. Команда сверит lock-файлы с базой вредоносных пакетов и просканирует содержимое, ничего не устанавливая.
Как проверить MCP-конфигурации на машине?
Запустите `aguara scan --auto`: сканер найдет конфигурации поддерживаемых MCP-клиентов. Список конфигураций покажет `aguara discover`.
Как подключить Aguara в CI?
Добавьте `aguara audit . --ci` до установки зависимостей. Шаг падает на критических находках, а `--baseline` фиксирует уже известные находки.
Отправляет ли Aguara данные наружу?
Нет. README заявляет локальный анализ без выполнения пакетов, загрузки содержимого, телеметрии и вызовов LLM.
Какие менеджеры пакетов поддерживаются?
npm, PyPI, Go, Rust, PHP, Ruby, Java и .NET. Lock-файлы читаются без установки зависимостей.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСканер ищет в конфигах MCP у Claude Desktop, Cursor и VS Code утекшие ключи, опасные доступы и подключенные модели.
Сканер безопасности для агентов: проверяет код, MCP-серверы, промпты и пакеты, выдуманные моделью, и ставит оценку от A до F.
Статический сканер уязвимостей в коде ИИ-агентов и конфигурациях MCP с 66 правилами по OWASP Agentic Top 10
AgentShield проверяет папку .claude на ключи в открытом виде, широкие разрешения, опасные хуки и небезопасные MCP-серверы и ставит оценку от A до F
CLI-сканер безопасности для кода и ИИ-агентов: проверяет .claude, хуки, MCP-конфиги и SKILL.md до клонирования и ищет утекшие ключи
Сканер безопасности для MCP-серверов и скиллов агентов: ищет внедрение промптов, утечки секретов и подмену после одобрения.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Aguara (эта карточка) | нет | 94 | |
| Skill Scanner | нет | 2 724 | проверяет скиллы; Aguara дополнительно сверяет зависимости с базой вредоносных пакетов и разбирает настройки агента и CI |
| MCP Scanner | да | 1 117 | сканирует MCP-серверы; Aguara охватывает еще скиллы, зависимости и конфигурации Claude Code |
Коротко о README
Описаны быстрый старт, таблица проверок по типам объектов, поддерживаемые менеджеры пакетов, источники данных об угрозах (OSV и OpenSSF Malicious Packages), порядок внедрения в CI с baseline и подпись релизов. Отдельный раздел перечисляет ограничения.