Ship Safe CLI

Сканер безопасности для кода от ИИ: секреты, зависимости, MCP и CI, расследование находок с доказательствами и исправления с подтверждением

  • 861 ★ репозитория
  • Последний коммит
  • MIT
CLI

Широкий доступ

Почему такой уровень

  • Хуки записываются в ~/.claude/settings.json и видят каждую запись файла и команду Bash в Claude Code
  • Агент исправлений меняет файлы проекта, а с флагами `--branch --pr` создает ветку и открывает пул-реквест
  • Режимы с ИИ передают код провайдеру, а `--verify` отправляет найденные ключи их поставщикам
Все причины и проверки

asamassekou10/ship-safe

Установка

В терминале, через 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` флаг проверяет найденные ключи у провайдеров, то есть отправляет им запросы с этими ключами. Без флага ключи только находятся и расследуются по коду. Запускайте его на проектах и ключах, которые вы вправе проверять.

Обсуждение

Вопросов и отзывов пока нет.

AgentShield проверяет папку .claude на ключи в открытом виде, широкие разрешения, опасные хуки и небезопасные MCP-серверы и ставит оценку от A до F

CLIРасширенный доступ1,3 тыс.Звезды репозитория

CLI-сканер безопасности для кода и ИИ-агентов: проверяет .claude, хуки, MCP-конфиги и SKILL.md до клонирования и ищет утекшие ключи

CLIРасширенный доступ1 тыс.Звезды репозитория
Выбор редакции

CLI от Snyk, который находит на машине установленные MCP-серверы, скиллы и агентов и проверяет их на промпт-инъекции и вредоносные payload

CLIРасширенный доступ3,2 тыс.Звезды репозитория
Выбор редакции

Сканер безопасности для скиллов и MCP агентов: ищет промпт-инъекции, утечки данных и риски цепочки поставок до установки

CLIРасширенный доступ21 тыс.Звезды репозитория

Сканер безопасности для скиллов агентов: ищет промпт-инъекции, утечку данных и вредоносный код перед установкой

CLIРасширенный доступ2,6 тыс.Звезды репозитория

Команда safehouse запускает Claude Code, Codex и другие агенты в песочнице macOS: файлы закрыты по умолчанию, нужные папки открываются флагами

CLIРасширенный доступ2,1 тыс.Звезды репозитория

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

ЗаписьОфициальныйЗвезды репозиторияГлавное отличие
Ship Safe (эта запись)нет861
MEDUSAнет1 006CLI-сканер для кода и ИИ-агентов: проверяет .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. В конце дорожная карта и правила для вкладов в проект.

Бейдж для README

Сообщить о проблеме

Foxx AIShip Safe
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.