ship-safe v9.7.5

Finden Sie riskanten Code, KI-Agenten-Schwachstellen und Supply-Chain-Probleme, bevor sie ausgeliefert werden.

Website · Dokumentation · Sicherheit & Datenfluss · Benchmark · Preise · Blog · Mitwirken

Ship Safe CLI

Ship Safe ist ein KI-Sicherheitsscanner für moderne Software-Teams. Er läuft lokal in Ihrem Repository, findet Probleme im Anwendungscode, bei KI-Agenten, MCP-Konfigurationen, Prompts, Abhängigkeiten, CI/CD, Geheimnissen und cloud-nahen Konfigurationen und hilft Ihnen dann, sichere Korrekturen zu überprüfen und anzuwenden.

Starten Sie einen Scan mit einem einzigen Befehl:

npx ship-safe

Keine Anmeldung. Kein API-Schlüssel für den Scan erforderlich. Funktioniert offline für die Kernprüfungen. KI-gestützte Red-Team-Modi verwenden Ihren konfigurierten Anbieter, sofern verfügbar.

Verwenden Sie --no-ai, um einen vollständig lokalen Scan zu garantieren. Anbieterbasierte Klassifizierung, Tiefenanalyse und GPT-Red senden begrenzten Kontext direkt an Ihren ausgewählten Anbieter, nachdem Anmeldeinformationen nach bestem Bemühen maskiert wurden. Siehe Sicherheit & Datenfluss für genaue Grenzen und Kontextlimits.

Schnellstart

# Interaktive REPL: Scannen, Korrigieren und Fragen in einer Sitzung
npx ship-safe

# Vollständiger Audit: Geheimnisse + 29 Agenten + Abhängigkeiten + Sanierungsplan
npx ship-safe audit .

# KI-Agenten-Red-Team-Szenarien für agentenlesbaren Inhalt
npx ship-safe red-team . --gpt-red

# Interaktiver Korrektur-Agent: Planen, Diff, Genehmigen, Verifizieren
npx ship-safe agent .
npx ship-safe agent . --severity critical   # nur kritische Befunde
npx ship-safe agent . --branch --pr         # auf einem Branch korrigieren + PR öffnen

# Letzte Korrektur rückgängig machen
npx ship-safe undo

# CI/CD-Modus — schlägt bei jedem kritischen Befund fehl
npx ship-safe ci . --sarif results.sarif
npx ship-safe ci . --fail-on high          # strenger: kritisch oder hoch

Was Ship Safe findet

So funktioniert es

1. Lokal scannen - Ship Safe untersucht Ihr Repository mit gezielten Agenten und überspringt Prüfungen, die nicht zutreffen.
2. Befunde überprüfen - Befunde enthalten Schweregrad, Dateispeicherort, Nachweis und empfohlene Sanierung.
3. Kontrolliert korrigieren - Der Agent schlägt einen Plan und ein Diff vor, fragt vor dem Schreiben, verifiziert das Ergebnis und hält Änderungen reversibel.
4. In CI absichern - Verwenden Sie ship-safe ci, um riskante Builds fehlschlagen zu lassen und SARIF in die GitHub-Code-Scanning-Funktion hochzuladen.

Warum Entwickler es verwenden

• Für KI-native Apps gebaut: erkennt Risiken in Agenten, MCP-Servern, Prompts, RAG-Flows, verwalteten Agenten-Konfigurationen und KI-gestützter CI.
• Funktioniert mit KI-Clients: Stellen Sie Ship Safe Codex, Claude Desktop, Cursor, Windsurf und anderen MCP-Clients über den lokalen stdio-Server bereit.
• Schnelles lokales Feedback: Führen Sie es vor einem PR, während der Überprüfung oder in CI aus, ohne Code an einen gehosteten Scanner zu senden.
• Korrekturen sind überprüfbar: Jede vorgeschlagene Änderung wird als Diff angezeigt, bevor sie Ihre Dateien berührt.
• Funktioniert mit Ihrem Stack: JavaScript, TypeScript, Python, Konfigurationsdateien, Infrastrukturdateien, GitHub Actions und mehr.
• Open-Source-Kern: MIT-lizenzierte CLI mit Dokumentation, Beispielen und einem wachsenden Agentensystem.

Kostenlose CLI, kostenpflichtige Team-Workflows

Die Open-Source-CLI ist der schnellste Weg, jedes Repository lokal zu scannen. Upgraden Sie, wenn Sie einen gehosteten Workflow rund um denselben Scanner benötigen:

Vergleichen Sie die Pläne unter shipsafe.sh/pricing.

Ship Safe Cloud, das gehostete Dashboard für Scan-Verlauf, PR Guardian, Abrechnung und Team-Workflows, wird in einem privaten Repository entwickelt, da es kommerziellen Produktcode und gehostete Infrastruktur-Workflows enthält. Das öffentliche ship-safe-Repository bleibt auf die MIT-lizenzierte CLI, Sicherheitsagenten, Regeln, Fixtures, CI-Integrationen und Dokumentation fokussiert. Siehe Ship Safe Cloud für die Repository-Grenze.

Sicherheitsagenten

Alle Agenten laufen parallel. Jeder überspringt automatisch irrelevante Projekte.

Nachprozessoren: ScoringEngine · VerifierAgent (Geheimnis-Liveness) · DeepAnalyzer (LLM-Taint-Analyse)

Die REPL

$ ship-safe

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

  v9.4.1  ·  DeepSeek  ·  ~/my-project

  /scan zum Finden von Problemen  ·  /agent zum Korrigieren  ·  /help für mehr

shipsafe ›

Alles, was nicht mit / beginnt, wird als Freitextfrage an das LLM gesendet, mit Ihren neuesten Scan-Ergebnissen als Kontext.

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

Eine GitLab-CI-Version finden Sie in docs/examples/gitlab-security-workflow.yml.

GitHub Action mit Inline-PR-Befunden

Verwenden Sie die Action aus einem pull_request-Workflow, wenn Sie kritische und hohe Befunde an den geänderten Zeilen anzeigen möchten. Halten Sie pull_request_target aus diesem Pfad für Fork-Beiträge heraus: Ship Safe lehnt diese privilegierte Kombination ab, da das Checkout nicht vertrauenswürdigen Code enthalten kann.

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

Inline-Kommentare sind opt-in und posten nur kritische/hohe Befunde. Das erneute Ausführen des Jobs aktualisiert die Zusammenfassung, ohne doppelte Inline-Kommentare zu erstellen.

LLM-Unterstützung

Funktioniert mit jedem Anbieter — automatisch aus Umgebungsvariablen erkannt. Verwenden Sie --provider <name>, um zu überschreiben.

Anthropic · OpenAI · Google · DeepSeek · Kimi K3 / Moonshot · Groq · Together · Mistral · xAI · Perplexity · Ollama · LM Studio · jeder OpenAI-kompatible Endpunkt

Kimi verwendet standardmäßig kimi-k3 über MOONSHOT_API_KEY oder KIMI_API_KEY. Verwenden Sie --provider kimi --model kimi-k3 für Long-Context-GPT-Red- und Tiefenanalyse-Läufe.

Für Kimi-K3-spezifisches Long-Context-Red-Teaming:

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

Ship Safe prüft auch Kimi-K3-/OpenAI-kompatible Tool-Call-Implementierungen auf dynamisches Tool-Laden aus Prompt-Kontext, fehlende Tool-Allowlists, erzwungene Tool-Aufrufe auf nicht vertrauenswürdigen Eingaben und wiedergegebene Tool-Ergebnisse ohne die ursprüngliche Assistant-Tool-Call-Nachricht.

Kein API-Schlüssel für das Kern-Scannen erforderlich. KI-Klassifizierung und red-team --gpt-red verwenden Ihren konfigurierten Anbieter, sofern verfügbar, mit deterministischem Offline-Fallback für GPT-Red-Prüfungen.

Falschpositive unterdrücken

password = get_password()  # ship-safe-ignore

kritische Befunde werden immer gemeldet. Ein Inline-Kommentar kann einen solchen nicht verbergen, und ein Versuch, einen zu unterdrücken, wird im Scan protokolliert. Der Kommentar ist für einen Menschen gedacht, der ein Falschpositiv ausschließt, und alles, was eine Zeile Ihres Quellcodes schreiben kann — einschließlich eines KI-Agenten — kann den Kommentar ebenfalls schreiben, daher berücksichtigen die höchsten Schweregrade ihn nicht. Jede Unterdrückung wird gezählt, sodass ein Scan, der Befunde verschwiegen hat, nie wie einer ohne Befunde aussieht.

# .ship-safeignore
tests/fixtures/
docs/

Wie laut ist es?

Recall ist die einfache Hälfte eines Scanners. Ein Tool, das alles markiert, erfasst alles und ist nutzlos, daher messen wir die andere Hälfte: was Ship Safe über Code sagt, der mit ziemlicher Sicherheit in Ordnung ist.

Reduziert von 1031 Befunden über dieselben vier Projekte vor v9.6.3, verifiziert gegen NodeGoat und DVWA, sodass der Rückgang reduziertes Rauschen und nicht verlorene Erkennung ist. Das 1 verbleibende kritische ist ein Falschpositiv, und der Benchmark sagt, welches und warum.

Korpus per Commit gepinnt, mit einem Befehl reproduzierbar, Limits dokumentiert: benchmarks/false-positives/

Wie schneidet es im Vergleich zu Semgrep, Gitleaks, Trivy, CodeQL ab?

Führen Sie Ship Safe neben ihnen aus, nicht stattdessen. CodeQL führt eine interprozedurale Taint-Analyse durch, die Ship Safe nicht versucht, Gitleaks ist der Spezialist für Geheimnisse, und Trivy hat eine echte CVE-Datenbank dahinter.

Ship Safe deckt eine engere Frage ab: was ein KI-Codierungsagent gerade mit Ihrem Repository, Ihrer CI und Ihrer lokalen Tool-Konfiguration gemacht hat. MCP-Client-Konfiguration, Agenten-Speichervergiftung, halluzinierte Paketimporte und AIBOM sind die Bereiche, in denen wir keine gleichwertigen öffentlichen Regeln in den anderen vier gefunden haben.

Vollständige Abdeckungsmatrix, verifiziert gegen ihre öffentlichen Registries, einschließlich wo sie uns schlagen: docs/comparison.md

Ein Badge hinzufügen

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

Was als Nächstes kommt

10.0 ist Hermes-Agenten-Abdeckung. Ship Safe scannt bereits Hermes-Bereitstellungen, aber gegen v0.13.0, während Hermes auf v0.20.0 ist — der ACP-Adapter, das TUI-Gateway, serverlose Terminal-Backends, Cron-Blueprints und Plugin-Manifeste wurden alle dazwischen ohne Abdeckung veröffentlicht.

Siehe die Roadmap für das, was geplant ist und was bewusst nicht geplant ist, und das 10.0-Meilenstein für beanspruchbare Arbeit. Alles darin ist offen für Mitwirkende.

Mitwirken

Ship Safe ist Open Source, und die besten Beiträge sind kleine, fokussierte Verbesserungen, die KI-gestützte Entwicklung sicherer machen.

Gute erste Bereiche:

• Einen fokussierten Sicherheitsagenten für ein KI-, MCP-, CI-, Cloud- oder Supply-Chain-Risiko hinzufügen
• Eine präzise Sicherheitsregel zu einem bestehenden Agenten hinzufügen
• Verwundbare Fixtures und Regressionstests hinzufügen
• Beispiele für lokale Scans, CI-Gates, Red-Team-Workflows und MCP/Agenten-Setup schreiben

Beginnen Sie hier:

• Gute erste Issues
• Mitwirkenden-Leitfaden
• Einen Agenten hinzufügen
• Eine Sicherheitsregel hinzufügen
• MCP-Umgebungsvariablen sicher behandeln
• Ship Safe mit Codex verwenden
• Ship Safe mit Claude Code verwenden
• Release-Prozess

Sponsoren

Ship Safe ist MIT-lizenziert und für immer kostenlos.

Stern-Verlauf

Schnell ausliefern. Sicher ausliefern. — shipsafe.sh