Herramienta CLI basada en Go que escanea bases de código para verificar la preparación para el lanzamiento, detectando configuraciones faltantes, problemas de higiene de seguridad, fugas de secretos y brechas de integración antes del despliegue en producción.
Preflight.sh es una herramienta de línea de comandos que analiza tu base de código para verificar la preparación para el lanzamiento. Identifica configuraciones faltantes, problemas de integración, riesgos de seguridad, carencias en los metadatos SEO y otros errores comunes antes de que despliegues a producción.
No te avergüences en producción. Solo ejecuta el comando.
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
Descarga la última versión desde GitHub Releases.
A partir de la v0.23.0, cada archivo incluye procedencia de compilación firmada. Para verificar que una descarga fue compilada por el flujo de trabajo de publicación de este repositorio:
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
Este repositorio incluye una habilidad de agente compatible con skills.sh en skills/preflight/SKILL.md. Proporciona a los agentes de programación un flujo de trabajo Preflight repetible: inspeccionar preflight.yml, ejecutar escaneos seguros para CI, clasificar los hallazgos, evitar ignorados inseguros, volver a ejecutar la validación e informar el riesgo residual de lanzamiento.
Enumera la habilidad desde este repositorio:
# With Bun
bunx --yes skills add preflightsh/preflight --list
# Or with npm
npx --yes skills add preflightsh/preflight --list
Instala solo la skill Preflight:
# With Bun
bunx --yes skills add preflightsh/preflight --skill preflight
# Or with npm
npx --yes skills add preflightsh/preflight --skill preflight
Preflight es totalmente utilizable desde la línea de comandos sin necesidad de una cuenta. El panel opcional en app.preflight.sh añade un historial alojado de tus escaneos y sugerencias de corrección generadas por IA para cada hallazgo. Tu código nunca sale de tu máquina: el escaneo se ejecuta localmente y no se envía nada a menos que publiques. Los tokens de portador del panel están restringidos al origen que los emitió, y las redirecciones autenticadas no pueden cruzar orígenes ni degradar HTTPS.
security_headers, ssl, www_redirect, email_auth, debug_statements, error_pages, image_optimization, legal_pages y las comprobaciones de archivos estándar web. debug_statements e image_optimization incluyen hasta cinco hallazgos (archivo y línea, o archivo y tamaño).seoMeta y los nombres de los archivos env, así como las credenciales de URL, las cadenas de consulta y los fragmentos.secrets, vulnerability, env_parity, health_endpoint, stripe, index_now, todas las comprobaciones de servicios y cualquier error de tipo "Check failed:".preflight.yml redactado: nombre del proyecto, stack, orígenes de URL, declaraciones de servicios y qué comprobaciones están habilitadas. Se omiten la clave de IndexNow, la URL del webhook de Stripe, la lista de permitidos de secretos, los nombres de los archivos env, la ruta de salud, la ruta del layout y la lista de ignorados.Las sugerencias, el contenido de los archivos, la salida de la herramienta de auditoría y los valores secretos nunca se envían.
Crea una cuenta gratuita y luego conecta la 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
Publica un escaneo en tu panel con --publish. Imprime un enlace para ver la ejecución. La publicación es de mejor esfuerzo: si no tienes conexión o no has iniciado sesión, el escaneo se ejecuta igualmente y finaliza con normalidad.
preflight scan --publish
En el panel de control se obtiene el desglose de aprobados/advertencias/fallos de cada ejecución, la lista de resultados de las comprobaciones y un historial por proyecto para ver qué cambió entre despliegues.
También se puede consultar ese historial desde la terminal con preflight history:
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
Requiere preflight auth login. --here empareja las ejecuciones con el repositorio actual mediante su remoto git, la misma clave que se usa al publicar. Una app escaneada desde un subdirectorio de su repositorio (una app en un monorepo) también se identifica por ese subdirectorio, por lo que apps/web y apps/api se publican en proyectos separados del panel. history --format json incluye los mismos campos schema_version y cli_version que el JSON de escaneo.
En CI u otra máquina sin navegador, inicia sesión con un token en su lugar: preflight auth login --token - lo lee desde stdin, o establece PREFLIGHT_TOKEN y ejecuta preflight auth login. En cualquier caso, el token se verifica y se almacena igual que un inicio de sesión con navegador; los comandos posteriores leen las credenciales almacenadas, no la variable.
Abre cualquier comprobación fallida o con advertencia en una ejecución publicada para generar una corrección paso a paso adaptada a tu stack detectado, con comandos y código listos para copiar.