Ship Safe CLI
Сканер безопасности для кода от ИИ: секреты, зависимости, MCP и CI, расследование находок с доказательствами и исправления с подтверждением
- 861 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Хуки записываются в ~/.claude/settings.json и видят каждую запись файла и команду Bash в Claude Code
- Агент исправлений меняет файлы проекта, а с флагами `--branch --pr` создает ветку и открывает пул-реквест
- Режимы с ИИ передают код провайдеру, а `--verify` отправляет найденные ключи их поставщикам
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ship-safeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Хуки записываются в ~/.claude/settings.json и видят каждую запись файла и команду Bash в Claude Code
- Агент исправлений меняет файлы проекта, а с флагами `--branch --pr` создает ветку и открывает пул-реквест
- Режимы с ИИ передают код провайдеру, а `--verify` отправляет найденные ключи их поставщикам
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ship Safe — консольный сканер безопасности для проектов, где код пишет ИИ. Он запускается через npx без регистрации и ключа API и проверяет секреты, зависимости, настройки CI, промпты, конфиги MCP и код приложения. Команда `npx ship-safe audit .` прогоняет поиск секретов, 31 проверяющего агента и зависимости и выдает план исправлений. Среди проверок внедрение SQL и NoSQL, XSS, SSRF, обход авторизации, подмена пакетов, опасные скрипты установки и отравление памяти агента или инструментов MCP. Слой расследования `npx ship-safe investigate .` прослеживает значение от входа запроса до опасного места в коде и раскладывает находки на подтвержденные, вероятные, нерешенные и опровергнутые, каждую с цепочкой строк-доказательств. Флаг `--verify` дополнительно проверяет найденные ключи у их поставщиков. Команда `trust` показывает, что запустится при открытии незнакомой папки агентом, а `capabilities` читает настройки MCP и разрешения и называет опасные сочетания, например заранее выданные права на запись и `git push`. Исправления делает интерактивный агент `npx ship-safe agent .`: план, diff, подтверждение и повторное сканирование, а `undo` откатывает последнюю правку. В CI команда `ci` пишет отчет SARIF и падает по порогу серьезности или по вердикту. В Claude Code Ship Safe ставится плагином с девятью скиллами или хуками, которые блокируют запись секретов и опасные команды Bash, а MCP-сервер `npx ship-safe mcp` дает Codex, Claude Desktop, Cursor и Windsurf шесть инструментов.
Для кого. Разработчикам и небольшим командам, которые принимают код от ИИ-агентов и хотят проверять его локально и в CI, а также тем, кто открывает чужие репозитории агентом.
Подходит, если
- Агент написал много кода, и перед пул-реквестом нужно найти секреты, уязвимости и опасные зависимости
- В CI нужен барьер с отчетом SARIF и порогом по серьезности или только по подтвержденным находкам
- Вы собираетесь открыть агентом чужой или скачанный репозиторий, и команда `trust` должна показать, что запустится при открытии
- Нужно понять, до чего дотянется агент в проекте: команда `capabilities` читает разрешения и настройки MCP
- Файлы правил агента (`.cursorrules`, `CLAUDE.md`) и конфиги MCP нужно проверить на внедрение промпта
Не подходит, если
- На машине стоит Node.js 18 или 20: поддерживается ветка 22 начиная с 22.13 и Node.js 24 или новее
- Нужны глубокий анализ потока данных как у CodeQL, специализированный поиск секретов как у Gitleaks или база CVE как у Trivy: автор советует запускать Ship Safe рядом с ними, а не вместо
- Код нельзя отправлять внешнему провайдеру: режимы с ИИ передают ему контекст, поэтому запускайте с `--no-ai`
- Нужны история сканирований, панель и отчеты PDF: это платные тарифы Ship Safe Cloud, кода этой части в репозитории нет
Пример запроса к агенту
Проверь проект перед пул-реквестом на секреты, уязвимости и опасные конфиги MCP и покажи только подтвержденные находки с доказательствамиОграничения
- Число находок не равно числу дефектов. На зрелых проектах (express, flask, requests, chalk) инструмент дает от 4 до 17 сырых находок, и автор уточняет, что это не доля ложных срабатываний.
- Режимы с ИИ (классификация, глубокий анализ, red-team GPT-Red) отправляют выбранному провайдеру ограниченный контекст после частичного маскирования ключей. Ключ `--no-ai` гарантирует полностью локальный запуск, а базовые проверки работают и без сети.
- Комментарий `ship-safe-ignore` не скрывает критические находки, попытка скрыть их записывается в отчет.
- Обычные правила не оценивают прозу и примеры кода в Markdown, секреты ищутся везде. Примеры включает флаг `--include-doc-examples`.
- Открытый репозиторий — CLI под лицензией MIT. История сканирований, PR Guardian и командные функции входят в платные тарифы Pro и Team в закрытом репозитории.
Как отключить. Хуки снимает команда `npx ship-safe@latest hooks remove`, а `hooks status` покажет состояние. Плагин уберите из Claude Code, запись ship-safe удалите из mcpServers вашего клиента, шаг со Ship Safe уберите из рабочего процесса CI. Файлы отчетов и базовой линии, которые вы создавали, удалите вручную.
Частые вопросы
Как проверить код, написанный ИИ, на уязвимости перед пул-реквестом?
Выполните `npx ship-safe audit .` в корне проекта: команда ищет секреты, прогоняет 31 проверяющего агента и зависимости и составляет план исправлений. Затем `npx ship-safe investigate .` отделит подтвержденные находки от опровергнутых и покажет цепочку строк. Подробности по неразобранным и опровергнутым дает флаг `--all`.
Нужны ли ключ API или регистрация для Ship Safe?
Для сканирования нет, и базовые проверки работают без сети. Режимы с ИИ используют провайдера, которого Ship Safe определяет по переменным окружения: список включает Anthropic, OpenAI, Google, DeepSeek, Moonshot, Groq, Mistral, xAI, Ollama и LM Studio. Провайдера можно задать флагом `--provider`.
Как подключить Ship Safe к Claude Code?
Плагин ставит команда `claude plugin add github:asamassekou10/ship-safe`, после нее доступны скиллы `/ship-safe`, `/ship-safe-scan`, `/ship-safe-fix` и другие. Скилл `/ship-safe-hooks` выполняет `npx ship-safe@latest hooks install` и записывает хуки PreToolUse и PostToolUse в ~/.claude/settings.json: запись секретов и опасные команды Bash блокируются до выполнения.
Как запустить Ship Safe в CI и не блокировать работу из-за старых проблем?
Команда `npx ship-safe ci . --sarif results.sarif` пишет отчет SARIF, порог задает `--fail-on high`, а `--fail-on-verdict confirmed` ломает сборку только по подтвержденным находкам. Для старых проблем снимите базовый отчет на доверенной ветке с `--write-baseline-report` и передайте его на PR через `--base-report`: новые, исправленные и прежние находки будут разделены.
Что делает флаг --verify?
В режиме `investigate` флаг проверяет найденные ключи у провайдеров, то есть отправляет им запросы с этими ключами. Без флага ключи только находятся и расследуются по коду. Запускайте его на проектах и ключах, которые вы вправе проверять.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыAgentShield проверяет папку .claude на ключи в открытом виде, широкие разрешения, опасные хуки и небезопасные MCP-серверы и ставит оценку от A до F
CLI-сканер безопасности для кода и ИИ-агентов: проверяет .claude, хуки, MCP-конфиги и SKILL.md до клонирования и ищет утекшие ключи
CLI от Snyk, который находит на машине установленные MCP-серверы, скиллы и агентов и проверяет их на промпт-инъекции и вредоносные payload
Сканер безопасности для скиллов и MCP агентов: ищет промпт-инъекции, утечки данных и риски цепочки поставок до установки
Сканер безопасности для скиллов агентов: ищет промпт-инъекции, утечку данных и вредоносный код перед установкой
Команда safehouse запускает Claude Code, Codex и другие агенты в песочнице macOS: файлы закрыты по умолчанию, нужные папки открываются флагами
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Ship Safe (эта запись) | нет | 861 | |
| MEDUSA | нет | 1 006 | CLI-сканер для кода и ИИ-агентов: проверяет .claude, хуки, MCP-конфиги и SKILL.md до клонирования, ищет утекшие ключи |
| Vibe Security | нет | 1 142 | скилл для аудита вайбкод-приложений: секреты, RLS в Supabase, авторизация, платежи, лимиты запросов |
| HOL Guard | да | 971 | проверяет команды агента, чтение секретов, вызовы MCP и установку пакетов во время работы и ждет вашего решения |
Коротко о README
Главная страница репозитория начинается с примера вывода `investigate` на учебном приложении OWASP NodeGoat и команды `npx ship-safe`. Дальше идут быстрый старт с командами аудита, расследования, `trust`, `capabilities`, red-team, агента исправлений и CI, описание формата отчетов JSON и SARIF, таблица областей проверки и таблица агентов по категориям. Есть примеры рабочих процессов GitHub Actions и GitLab, список поддерживаемых провайдеров ИИ, правила подавления ложных срабатываний, замеры шума на четырех зрелых проектах и сравнение с Semgrep, Gitleaks, Trivy и CodeQL. В конце дорожная карта и правила для вкладов в проект.