Go-basiertes CLI-Tool, das Codebasen auf Startbereitschaft durchsucht und fehlende Konfiguration, Probleme der Sicherheitshygiene, Geheimnislecks und Integrationslücken vor der Produktionsbereitstellung erkennt.
Preflight.sh ist ein Kommandozeilen-Tool, das deine Codebasis auf Startbereitschaft (Launch Readiness) prüft. Es identifiziert fehlende Konfiguration, Integrationsprobleme, Sicherheitsbedenken, Lücken bei SEO-Metadaten und andere häufige Fehler, bevor du in die Produktion deployst.
Blamiere dich nicht in der Produktion. Führe einfach den Befehl aus.
brew install preflightsh/preflight/preflight
npm install -g @preflightsh/preflight
go install github.com/preflightsh/preflight@latest
docker pull ghcr.io/preflightsh/preflight
curl -fsSL https://preflight.sh/install.sh | sh
Laden Sie die neueste Version von GitHub Releases herunter.
Ab v0.23.0 enthält jedes Archiv eine signierte Build-Provenienz. Um zu überprüfen, ob ein Download vom Release-Workflow dieses Repos erstellt wurde:
gh attestation verify preflight_<version>_<os>_<arch>.tar.gz --repo preflightsh/preflight
# Initialize in your project directory
cd your-project
preflight init
# (asks before replacing an existing preflight.yml; --force skips the question)
# In a script or CI job, where nobody can answer, pass --yes to accept the
# detected defaults. Without it, init stops and writes nothing when its input
# ends before the questions do.
# Run all checks
preflight scan
# Scan a specific directory
preflight scan /path/to/project
# Run with verbose output (shows which files matched each check)
preflight scan --verbose
preflight scan -v # short form
# Run in CI mode with JSON output
preflight scan --ci --format json
# Run only specific checks, or skip some, for fast iteration
# (one-off; unlike `preflight ignore` it doesn't change preflight.yml)
preflight scan --only seo_meta,og_twitter
preflight scan --skip vulnerability,secrets
# Silence a check
preflight ignore sitemap
# Unsilence a check
preflight unignore sitemap
# List all check IDs
preflight checks
Dieses Repository enthält einen skills.sh-kompatiblen Agent Skill unter skills/preflight/SKILL.md. Er vermittelt Coding-Agenten einen wiederholbaren Preflight-Workflow: preflight.yml prüfen, CI-sichere Scans ausführen, Befunde triagieren, unsichere Ignorierungen vermeiden, die Validierung erneut ausführen und das verbleibende Startrisiko melden.
Den Skill aus diesem Repository auflisten:
# With Bun
bunx --yes skills add preflightsh/preflight --list
# Or with npm
npx --yes skills add preflightsh/preflight --list
Installiere nur die Preflight-Skill:
# With Bun
bunx --yes skills add preflightsh/preflight --skill preflight
# Or with npm
npx --yes skills add preflightsh/preflight --skill preflight
Preflight ist vollständig über die Befehlszeile nutzbar, ohne Konto. Das optionale Dashboard unter app.preflight.sh ergänzt einen gehosteten Verlauf deiner Scans und KI-generierte Korrekturvorschläge für jeden Befund. Dein Code verlässt niemals deinen Rechner: Das Scannen läuft lokal ab, und es wird nichts gesendet, es sei denn, du veröffentlichst. Bearer-Tokens des Dashboards sind auf den Ursprung beschränkt, der sie ausgestellt hat, und authentifizierte Weiterleitungen können keine Ursprünge überschreiten oder HTTPS herabstufen.
security_headers, ssl, www_redirect, email_auth, debug_statements, error_pages, image_optimization, legal_pages und die Prüfungen auf Webstandard-Dateien. debug_statements und image_optimization enthalten bis zu fünf Befunde (Datei und Zeile bzw. Datei und Größe).seoMeta-Layoutpfad und die Namen der Env-Dateien werden entfernt, ebenso URL-Anmeldedaten, Query-Strings und Fragmente.secrets, vulnerability, env_parity, health_endpoint, stripe, index_now, jede Dienstprüfung und jeder „Check failed:“-Fehler.preflight.yml: Projektname, Stack, URL-Ursprünge, Dienstdeklarationen und welche Prüfungen aktiviert sind. Der IndexNow-Schlüssel, die Stripe-Webhook-URL, die Secrets-Allowlist, die Namen der Env-Dateien, der Health-Pfad, der Layoutpfad und die Ignorierliste werden weggelassen.Vorschläge, Dateiinhalte, Ausgaben von Prüfwerkzeugen und geheime Werte werden niemals gesendet.
Erstelle ein kostenloses Konto und verbinde dann die CLI:
preflight auth login # opens your browser to authorize this CLI
preflight auth status # show who you're logged in as
preflight auth logout # remove stored credentials
Veröffentliche einen Scan mit --publish in deinem Dashboard. Es wird ein Link zur Anzeige des Laufs ausgegeben. Das Veröffentlichen erfolgt nach bestem Bemühen: Wenn du offline bist oder nicht angemeldet bist, wird der Scan trotzdem ausgeführt und endet normal.
preflight scan --publish
Auf dem Dashboard erhalten Sie die Aufschlüsselung nach Bestanden/Warnungen/Fehlern für jeden Lauf, die Liste der Prüfergebnisse und einen projektbezogenen Verlauf, sodass Sie sehen können, was sich zwischen Deployments geändert hat.
Sie können diesen Verlauf auch im Terminal mit preflight history lesen:
preflight history # recent runs across your projects
preflight history --here # only the current project's runs
preflight history <run-id> # one run's full check results
preflight history --here --format json # machine-readable, for agents
Erfordert preflight auth login. --here ordnet Läufe dem aktuellen Repository über dessen Git-Remote zu, demselben Schlüssel, der beim Veröffentlichen verwendet wird. Eine App, die aus einem Unterverzeichnis ihres Repositorys gescannt wird (eine App in einem Monorepo), wird ebenfalls über dieses Unterverzeichnis zugeordnet, sodass apps/web und apps/api in separate Dashboard-Projekte veröffentlichen. history --format json enthält dieselben Felder schema_version und cli_version wie das Scan-JSON.
Auf CI oder einer anderen Maschine ohne Browser melden Sie sich stattdessen mit einem Token an: preflight auth login --token - liest es von stdin, oder setzen Sie PREFLIGHT_TOKEN und führen Sie preflight auth login aus. In beiden Fällen wird das Token geprüft und wie bei einer Browser-Anmeldung gespeichert; spätere Befehle lesen die gespeicherten Anmeldedaten, nicht die Variable.
Öffnen Sie eine fehlgeschlagene oder warnende Prüfung eines veröffentlichten Laufs, um eine schrittweise Lösung zu generieren, die auf Ihren erkannten Stack zugeschnitten ist, mit kopierfertigen Befehlen und Code.