ship-safe v9.7.5

Находите рискованный код, уязвимости ИИ-агентов и проблемы цепочки поставок до того, как они попадут в продакшн.

Веб-сайт · Документация · Безопасность и потоки данных · Бенчмарки · Цены · Блог · Участие

Ship Safe CLI

Ship Safe — это ИИ-сканер безопасности для современных команд разработчиков. Он запускается локально в вашем репозитории, находит проблемы в коде приложения, ИИ-агентах, конфигурациях MCP, промптах, зависимостях, CI/CD, секретах и облачных конфигурациях, а затем помогает просмотреть и применить безопасные исправления.

Запустите сканирование одной командой:

npx ship-safe

Без регистрации. Для сканирования не требуется API-ключ. Базовые проверки работают офлайн. Режимы red-team с поддержкой ИИ используют вашего настроенного провайдера, когда он доступен.

Используйте --no-ai, чтобы гарантировать полностью локальное сканирование. Классификация на основе провайдера, глубокий анализ и GPT-Red отправляют ограниченный контекст напрямую вашему выбранному провайдеру после маскировки учётных данных с максимальными усилиями. Точные границы и лимиты контекста см. в разделе Безопасность и потоки данных.

Быстрый старт

# Интерактивный REPL: сканирование, исправление и вопросы в одном сеансе
npx ship-safe

# Полный аудит: секреты + 29 агентов + зависимости + план исправлений
npx ship-safe audit .

# Сценарии red-team для ИИ-агентов для контента, читаемого агентами
npx ship-safe red-team . --gpt-red

# Интерактивный агент исправлений: план, diff, одобрение, проверка
npx ship-safe agent .
npx ship-safe agent . --severity critical   # только критические находки
npx ship-safe agent . --branch --pr         # исправление в ветке + открытие PR

# Отменить последнее исправление
npx ship-safe undo

# Режим CI/CD — завершается с ошибкой при любой критической находке
npx ship-safe ci . --sarif results.sarif
npx ship-safe ci . --fail-on high          # строже: критическая или высокая

Что находит Ship Safe

Как это работает

1. Локальное сканирование — Ship Safe проверяет ваш репозиторий с помощью целевых агентов и пропускает проверки, которые не применимы.
2. Просмотр находок — Находки включают серьёзность, расположение файла, доказательства и рекомендуемые меры по исправлению.
3. Исправление с контролем — Агент предлагает план и diff, спрашивает перед записью, проверяет результат и сохраняет изменения обратимыми.
4. Контроль в CI — Используйте ship-safe ci, чтобы блокировать рискованные сборки и загружать SARIF в сканирование кода GitHub.

Почему разработчики его используют

• Создан для ИИ-нативных приложений: выявляет риски в агентах, MCP-серверах, промптах, RAG-потоках, конфигурациях управляемых агентов и ИИ-управляемом CI.
• Работает с ИИ-клиентами: подключайте Ship Safe к Codex, Claude Desktop, Cursor, Windsurf и другим MCP-клиентам через локальный stdio-сервер.
• Быстрая локальная обратная связь: запускайте его перед PR, во время ревью или в CI без отправки кода на хостинговый сканер.
• Исправления проверяемы: каждое предлагаемое изменение показывается как diff до того, как оно коснётся ваших файлов.
• Работает с вашим стеком: JavaScript, TypeScript, Python, файлы конфигурации, файлы инфраструктуры, GitHub Actions и многое другое.
• Открытое ядро: CLI под лицензией MIT с документацией, примерами и растущей системой агентов.

Бесплатный CLI, платные командные рабочие процессы

CLI с открытым исходным кодом — это самый быстрый способ сканировать любой репозиторий локально. Обновитесь, когда вам понадобится хостинговый рабочий процесс вокруг того же сканера:

Сравните тарифы на shipsafe.sh/pricing.

Ship Safe Cloud, хостинговая панель для истории сканирований, PR Guardian, биллинга и командных рабочих процессов, разрабатывается в приватном репозитории, поскольку содержит коммерческий код продукта и инфраструктурные рабочие процессы. Публичный репозиторий ship-safe остаётся сосредоточенным на CLI под лицензией MIT, агентах безопасности, правилах, фикстурах, интеграциях CI и документации. Границы репозитория см. в Ship Safe Cloud.

Агенты безопасности

Все агенты работают параллельно. Каждый автоматически пропускает неподходящие проекты.

Пост-процессоры: ScoringEngine · VerifierAgent (проверка активности секретов) · DeepAnalyzer (LLM-анализ потоков данных)

REPL

$ ship-safe

  ███████╗██╗  ██╗██╗██████╗     ███████╗ █████╗ ███████╗███████╗
  ...

  v9.4.1  ·  DeepSeek  ·  ~/my-project

  /scan для поиска проблем  ·  /agent для их исправления  ·  /help для справки

shipsafe ›

Всё, что не начинается с /, отправляется LLM как свободный вопрос с вашими последними результатами сканирования в качестве контекста.

CI/CD

# .github/workflows/security.yml
name: Security Audit
on: [push, pull_request]
jobs:
  security:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Security gate
        run: npx ship-safe ci . --sarif results.sarif
      - uses: github/codeql-action/upload-sarif@v3
        if: always()
        with:
          sarif_file: results.sarif

Версия для GitLab CI находится в docs/examples/gitlab-security-workflow.yml.

GitHub Action с инлайн-находками в PR

Используйте Action из рабочего процесса pull_request, когда вы хотите, чтобы критические и высокие находки прикреплялись к изменённым строкам. Держите pull_request_target подальше от этого пути для форк-контрибуций: Ship Safe отказывается от этой привилегированной комбинации, потому что checkout может содержать ненадёжный код.

name: Ship Safe
on:
  pull_request:

permissions:
  contents: read
  pull-requests: write
  security-events: write

jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: asamassekou10/[email protected]
        with:
          fail-on: high
          inline: true

Инлайн-комментарии включаются по желанию и публикуют только критические/высокие находки. Повторный запуск задания обновляет сводку без создания дублирующих инлайн-комментариев.

Поддержка LLM

Работает с любым провайдером — автоматически определяется из переменных окружения. Используйте --provider <name> для переопределения.

Anthropic · OpenAI · Google · DeepSeek · Kimi K3 / Moonshot · Groq · Together · Mistral · xAI · Perplexity · Ollama · LM Studio · любой OpenAI-совместимый эндпоинт

Kimi по умолчанию использует kimi-k3 через MOONSHOT_API_KEY или KIMI_API_KEY. Используйте --provider kimi --model kimi-k3 для длинноконтекстных GPT-Red и глубоких анализов.

Для длинноконтекстного red teaming с Kimi K3:

npx ship-safe red-team . --gpt-red --provider kimi --model kimi-k3 --k3-long-context

Ship Safe также проверяет реализации вызовов инструментов Kimi K3 / OpenAI-совместимых на динамическую загрузку инструментов из контекста промпта, отсутствие списков разрешений инструментов, принудительные вызовы инструментов на ненадёжном вводе и повторные результаты инструментов без исходного сообщения вызова инструмента ассистента.

Для базового сканирования API-ключ не требуется. ИИ-классификация и red-team --gpt-red используют вашего настроенного провайдера, когда он доступен, с детерминированным офлайн-фолбэком для проверок GPT-Red.

Подавление ложных срабатываний

password = get_password()  # ship-safe-ignore

Критические находки всегда сообщаются. Инлайн-комментарий не может скрыть их, и попытка подавить такую находку фиксируется в сканировании. Комментарий предназначен для человека, исключающего ложное срабатывание, и всё, что может записать строку вашего исходного кода — включая ИИ-агента — также может записать этот комментарий, поэтому самые высокие уровни серьёзности его не учитывают. Каждое подавление подсчитывается, поэтому сканирование, которое заглушило находки, никогда не выглядит как сканирование без них.

# .ship-safeignore
tests/fixtures/
docs/

Насколько оно шумное?

Полнота — это лёгкая половина сканера. Инструмент, который помечает всё, ловит всё и бесполезен, поэтому мы измеряем другую половину: что Ship Safe говорит о коде, который почти наверняка в порядке.

Снижение с 1031 находки по тем же четырём проектам до версии v9.6.3, проверено на NodeGoat и DVWA, чтобы снижение было уменьшением шума, а не потерей обнаружения. Оставшаяся 1 критическая находка — ложное срабатывание, и бенчмарк указывает, какая именно и почему.

Корпус закреплён по коммиту, воспроизводим одной командой, лимиты задокументированы: benchmarks/false-positives/

Как он сравнивается с Semgrep, Gitleaks, Trivy, CodeQL?

Запускайте Ship Safe вместе с ними, а не вместо них. CodeQL выполняет межпроцедурный анализ потоков данных, который Ship Safe не пытается делать, Gitleaks — специалист по секретам, а Trivy имеет реальную базу CVE за собой.

Ship Safe покрывает более узкий вопрос: что ИИ-агент кодирования только что сделал с вашим репозиторием, вашим CI и вашей локальной конфигурацией инструментов. Конфигурация MCP-клиентов, отравление памяти агентов, импорты галлюцинированных пакетов и AIBOM — это области, где мы не нашли эквивалентных публичных правил в остальных четырёх.

Полная матрица покрытия, проверенная по их публичным реестрам, включая то, где они нас превосходят: docs/comparison.md

Добавить бейдж

[![Ship Safe](https://img.shields.io/badge/Ship_Safe-A+-22c55e)](https://shipsafe.sh)

Что дальше

10.0 — это покрытие Hermes Agent. Ship Safe уже сканирует развёртывания Hermes, но против v0.13.0, тогда как Hermes находится на v0.20.0 — ACP-адаптер, TUI-шлюз, серверless терминальные бэкенды, cron-шаблоны и манифесты плагинов — всё это вышло в промежутке без покрытия.

См. дорожную карту для того, что запланировано и что намеренно не запланировано, и веху 10.0 для задач, доступных к выполнению. Всё в ней открыто для контрибьюторов.

Участие

Ship Safe — это открытый исходный код, и лучшие контрибуции — это небольшие, сфокусированные улучшения, которые делают ИИ-ассистированную разработку безопаснее.

Хорошие первые области:

• Добавьте сфокусированного агента безопасности для риска ИИ, MCP, CI, облака или цепочки поставок
• Добавьте точное правило безопасности в существующего агента
• Добавьте уязвимые фикстуры и регрессионные тесты
• Напишите примеры для локальных сканирований, CI-шлюзов, рабочих процессов red-team и настройки MCP/агентов

Начните здесь:

• Хорошие первые задачи
• Руководство контрибьютора
• Добавление агента
• Добавление правила безопасности
• Безопасная обработка переменных окружения MCP
• Использование Ship Safe с Codex
• Использование Ship Safe с Claude Code
• Процесс релиза

Спонсоры

Ship Safe распространяется под лицензией MIT и бесплатен навсегда.

История звёзд

Релиз быстро. Релиз безопасно. — shipsafe.sh