ship-safe v9.7.5

Detecta código riesgoso, vulnerabilidades de agentes de IA y problemas de cadena de suministro antes de que lleguen a producción.

Sitio web · Documentación · Seguridad y flujo de datos · Benchmark · Precios · Blog · Contribuir

CLI de Ship Safe

Ship Safe es un escáner de seguridad de IA para equipos de software modernos. Se ejecuta localmente en tu repositorio, encuentra problemas en código de aplicación, agentes de IA, configuraciones de MCP, prompts, dependencias, CI/CD, secretos y configuración relacionada con la nube, y luego te ayuda a revisar y aplicar correcciones seguras.

Inicia un escaneo con un solo comando:

npx ship-safe

Sin registro. No se requiere clave de API para escanear. Funciona sin conexión para las comprobaciones principales. Los modos de red-team respaldados por IA usan tu proveedor configurado cuando está disponible.

Usa --no-ai para garantizar un escaneo completamente local. La clasificación respaldada por proveedor, el análisis profundo y GPT-Red envían contexto limitado directamente a tu proveedor seleccionado después de un enmascaramiento de credenciales de mejor esfuerzo. Consulta Seguridad y flujo de datos para conocer los límites exactos y los límites de contexto.

Inicio rápido

# REPL interactivo: escanea, corrige y haz preguntas en una sola sesión
npx ship-safe

# Auditoría completa: secretos + 29 agentes + dependencias + plan de remediación
npx ship-safe audit .

# Escenarios de red-team de agentes de IA para contenido legible por agentes
npx ship-safe red-team . --gpt-red

# Agente de corrección interactivo: plan, diff, aprobar, verificar
npx ship-safe agent .
npx ship-safe agent . --severity critical   # solo hallazgos críticos
npx ship-safe agent . --branch --pr         # corregir en una rama + abrir un PR

# Deshacer la última corrección
npx ship-safe undo

# Modo CI/CD: falla ante cualquier hallazgo crítico
npx ship-safe ci . --sarif results.sarif
npx ship-safe ci . --fail-on high          # más estricto: crítico o alto

Qué encuentra Ship Safe

Cómo funciona

1. Escanea localmente - Ship Safe inspecciona tu repositorio con agentes específicos y omite las comprobaciones que no aplican.
2. Revisa los hallazgos - Los hallazgos incluyen severidad, ubicación del archivo, evidencia y remediación recomendada.
3. Corrige con control - El agente propone un plan y un diff, pregunta antes de escribir, verifica el resultado y mantiene los cambios reversibles.
4. Controla en CI - Usa ship-safe ci para fallar builds riesgosos y sube SARIF al escaneo de código de GitHub.

Por qué lo usan los desarrolladores

• Diseñado para aplicaciones nativas de IA: detecta riesgos en agentes, servidores MCP, prompts, flujos RAG, configuraciones de agentes gestionados y CI impulsado por IA.
• Funciona con clientes de IA: expón Ship Safe a Codex, Claude Desktop, Cursor, Windsurf y otros clientes MCP a través del servidor stdio local.
• Retroalimentación local rápida: ejecútalo antes de un PR, durante la revisión o dentro del CI sin enviar código a un escáner alojado.
• Las correcciones son revisables: cada cambio sugerido se muestra como un diff antes de tocar tus archivos.
• Funciona con tu stack: JavaScript, TypeScript, Python, archivos de configuración, archivos de infraestructura, GitHub Actions y más.
• Núcleo de código abierto: CLI con licencia MIT con documentación, ejemplos y un sistema de agentes en crecimiento.

CLI gratuito, flujos de trabajo de equipo de pago

El CLI de código abierto es la forma más rápida de escanear cualquier repositorio localmente. Mejora cuando necesites un flujo de trabajo alojado alrededor del mismo escáner:

Compara los planes en shipsafe.sh/pricing.

Ship Safe Cloud, el panel alojado para historial de escaneos, PR Guardian, facturación y flujos de trabajo de equipo, se desarrolla en un repositorio privado porque contiene código de producto comercial y flujos de trabajo de infraestructura alojada. El repositorio público ship-safe sigue centrado en el CLI con licencia MIT, agentes de seguridad, reglas, fixtures, integraciones de CI y documentación. Consulta Ship Safe Cloud para conocer el límite del repositorio.

Agentes de seguridad

Todos los agentes se ejecutan en paralelo. Cada uno omite automáticamente los proyectos irrelevantes.

Post-procesadores: ScoringEngine · VerifierAgent (liveness de secretos) · DeepAnalyzer (análisis de taint con LLM)

El REPL

$ ship-safe

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

  v9.4.1  ·  DeepSeek  ·  ~/my-project

  /scan para encontrar problemas  ·  /agent para corregirlos  ·  /help para más

shipsafe ›

Cualquier cosa que no comience con / se envía al LLM como una pregunta de formato libre, con los resultados de tu último escaneo como contexto.

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

Una versión para GitLab CI está en docs/examples/gitlab-security-workflow.yml.

GitHub Action con hallazgos en línea en PR

Usa la Action desde un flujo de trabajo pull_request cuando quieras hallazgos críticos y altos adjuntos a las líneas modificadas. Mantén pull_request_target fuera de esta ruta para contribuciones de forks: Ship Safe rechaza esa combinación privilegiada porque el checkout puede contener código no confiable.

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

Los comentarios en línea son opcionales y solo publican hallazgos críticos/altos. Re-ejecutar el trabajo actualiza el resumen sin crear comentarios en línea duplicados.

Soporte de LLM

Funciona con cualquier proveedor: se detecta automáticamente desde las variables de entorno. Usa --provider <name> para anular.

Anthropic · OpenAI · Google · DeepSeek · Kimi K3 / Moonshot · Groq · Together · Mistral · xAI · Perplexity · Ollama · LM Studio · cualquier endpoint compatible con OpenAI

Kimi usa por defecto kimi-k3 a través de MOONSHOT_API_KEY o KIMI_API_KEY. Usa --provider kimi --model kimi-k3 para ejecuciones de GPT-Red y análisis profundo de contexto largo.

Para red teaming de contexto largo específico de Kimi K3:

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

Ship Safe también verifica las implementaciones de llamadas a herramientas compatibles con Kimi K3 / OpenAI para carga dinámica de herramientas desde el contexto del prompt, listas de permitidos de herramientas faltantes, llamadas a herramientas forzadas en entradas no confiables y resultados de herramientas reproducidos sin el mensaje original de llamada a herramienta del asistente.

No se requiere clave de API para el escaneo principal. La clasificación con IA y red-team --gpt-red usan tu proveedor configurado cuando está disponible, con respaldo offline determinista para las comprobaciones GPT-Red.

Suprimir falsos positivos

password = get_password()  # ship-safe-ignore

Los hallazgos critical siempre se reportan. Un comentario en línea no puede ocultar uno, y un intento de suprimirlo se registra en el escaneo. El comentario está pensado para que un humano descarte un falso positivo, y cualquier cosa que pueda escribir una línea de tu código fuente — incluido un agente de IA — también puede escribir el comentario, por lo que las severidades más altas no lo honran. Cada supresión se cuenta, de modo que un escaneo que silenciara hallazgos nunca se lee como uno que no tuvo ninguno.

# .ship-safeignore
tests/fixtures/
docs/

¿Qué tan ruidoso es?

El recall es la mitad fácil de un escáner. Una herramienta que marca todo atrapa todo y es inútil, así que medimos la otra mitad: qué dice Ship Safe sobre código que casi con certeza está bien.

Bajó de 1031 hallazgos en los mismos cuatro proyectos antes de v9.6.3, verificado contra NodeGoat y DVWA para que la caída sea ruido reducido y no detección perdida. El 1 crítico restante es un falso positivo y el benchmark dice cuál y por qué.

Corpus fijado por commit, reproducible con un comando, límites documentados: benchmarks/false-positives/

¿Cómo se compara con Semgrep, Gitleaks, Trivy, CodeQL?

Ejecuta Ship Safe junto a ellos, no en lugar de ellos. CodeQL hace análisis de taint interprocedural que Ship Safe no intenta, Gitleaks es el especialista en secretos y Trivy tiene una base de datos real de CVEs detrás.

Ship Safe cubre una pregunta más acotada: qué le acaba de hacer un agente de codificación de IA a tu repositorio, tu CI y tu configuración local de herramientas. Configuración de clientes MCP, envenenamiento de memoria de agentes, imports de paquetes alucinados y AIBOM son las áreas donde no encontramos reglas públicas equivalentes en los otros cuatro.

Matriz de cobertura completa, verificada contra sus registros públicos, incluido dónde nos superan: docs/comparison.md

Añadir una insignia

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

Qué sigue

10.0 es cobertura de Hermes Agent. Ship Safe ya escanea despliegues de Hermes, pero contra v0.13.0 mientras Hermes está en v0.20.0 — el adaptador ACP, la puerta de enlace TUI, los backends de terminal serverless, los blueprints cron y los manifiestos de plugins se lanzaron en el medio sin cobertura.

Consulta la hoja de ruta para ver qué está planificado y qué deliberadamente no, y el hito 10.0 para trabajo reclamable. Todo en él está abierto a contribuyentes.

Contribuir

Ship Safe es de código abierto, y las mejores contribuciones son mejoras pequeñas y enfocadas que hacen más seguro el desarrollo asistido por IA.

Buenas áreas para empezar:

• Añadir un agente de seguridad enfocado para un riesgo de IA, MCP, CI, nube o cadena de suministro
• Añadir una regla de seguridad precisa a un agente existente
• Añadir fixtures vulnerables y pruebas de regresión
• Escribir ejemplos para escaneos locales, compuertas de CI, flujos de trabajo de red-team y configuración de MCP/agentes

Empieza aquí:

• Buenos primeros issues
• Guía del contribuyente
• Añadir un agente
• Añadir una regla de seguridad
• Manejar variables de entorno de MCP de forma segura
• Usar Ship Safe con Codex
• Usar Ship Safe con Claude Code
• Proceso de lanzamiento

Patrocinadores

Ship Safe tiene licencia MIT y es gratuito para siempre.

Historial de estrellas

Despliega rápido. Despliega seguro. — shipsafe.sh