
preflight v0.20.1
CLI-инструмент на базе Go, который сканирует кодовые базы на готовность к запуску, обнаруживая отсутствующую конфигурацию, проблемы гигиены безопасности, утечки секретов и пробелы интеграции перед развёртыванием в production.
Preflight.sh
Preflight.sh — это инструмент командной строки, который сканирует вашу кодовую базу на готовность к запуску. Выявляет отсутствующую конфигурацию, проблемы интеграции, проблемы безопасности, пробелы в SEO-метаданных и другие распространённые ошибки до развёртывания в production.
Не позорьтесь в production. Просто запустите команду.
Установка
Homebrew (macOS/Linux)
brew install preflightsh/preflight/preflight
npm
npm install -g @preflightsh/preflight
Go
go install github.com/preflightsh/preflight@latest
Docker
docker pull ghcr.io/preflightsh/preflight
Shell-скрипт
curl -fsSL https://preflight.sh/install.sh | sh
Ручная загрузка
Скачайте последний релиз со страницы GitHub Releases.
Начиная с v0.23.0 каждый архив содержит подписанные сведения о происхождении сборки. Чтобы проверить, что загруженный файл был собран в рамках workflow релиза этого репозитория:
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
Навык агента
Этот репозиторий включает совместимый со skills.sh навык агента по пути skills/preflight/SKILL.md. Он даёт агентам для программирования воспроизводимый рабочий процесс Preflight: проверить preflight.yml, запустить безопасные для CI сканирования, отсортировать находки, избегать небезопасных игнорирований, повторно запустить валидацию и сообщить об остаточном риске запуска.
Вывести список навыка из этого репозитория:
# With Bun
bunx --yes skills add preflightsh/preflight --list
# Or with npm
npx --yes skills add preflightsh/preflight --list
Установите только навык Preflight:
# With Bun
bunx --yes skills add preflightsh/preflight --skill preflight
# Or with npm
npx --yes skills add preflightsh/preflight --skill preflight
Панель управления и ИИ-рекомендации
Preflight полностью доступен из командной строки без учётной записи. Необязательная панель управления на app.preflight.sh добавляет размещённую историю ваших сканирований и сгенерированные ИИ рекомендации по исправлению для каждой находки. Ваш код никогда не покидает вашу машину: сканирование выполняется локально, и ничего не отправляется, пока вы не опубликуете. Токены доступа панели управления ограничены источником, который их выдал, а аутентифицированные перенаправления не могут пересекать источники или понижать HTTPS.
Что отправляется при публикации
- ID, заголовок, статус (пройдено, пропущено, неоднозначно, серьёзность) каждой проверки и сводные счётчики.
- Реальное сообщение для проверок, сообщения которых строятся из фиксированного текста, счётчиков, путей относительно репозитория, DNS-имён или содержимого публичных страниц: проверки SEO и соцсетей,
security_headers,ssl,www_redirect,email_auth,debug_statements,error_pages,image_optimization,legal_pagesи проверки файлов веб-стандартов.debug_statementsиimage_optimizationвключают до пяти находок (файл и строка или файл и размер). - Перед отправкой эти сообщения очищаются: настроенные URL staging и production обрезаются до их источников, а ключ IndexNow, URL вебхука Stripe, путь к макету
seoMetaи имена env-файлов удаляются, как и учётные данные в URL, строки запросов и фрагменты. - Общее сообщение для всего остального:
secrets,vulnerability,env_parity,health_endpoint,stripe,index_now, все проверки сервисов и любая ошибка "Check failed:". - Отредактированный
preflight.yml: имя проекта, стек, источники URL, объявления сервисов и какие проверки включены. Ключ IndexNow, URL вебхука Stripe, список разрешённых секретов, имена env-файлов, путь проверки работоспособности, путь к макету и список игнорирования удаляются.
Предложения, содержимое файлов, вывод инструментов аудита и секретные значения никогда не отправляются.
Создайте бесплатную учётную запись, затем подключите 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
Опубликуйте сканирование на своей панели управления с помощью --publish. Будет выведена ссылка для просмотра запуска. Публикация выполняется по мере возможности: если вы не в сети или не вошли в систему, сканирование всё равно выполнится и завершится нормально.
preflight scan --publish
На панели управления вы получаете разбивку результатов каждого запуска по категориям «пройдено/предупреждение/ошибка», список результатов проверок и историю по каждому проекту, чтобы видеть, что изменилось между развёртываниями.
Эту историю также можно просмотреть из терминала с помощью 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
Требуется preflight auth login. --here сопоставляет запуски с текущим репозиторием по его git remote — тот же ключ, который используется при публикации. Приложение, просканированное из подкаталога своего репозитория (одно приложение в монорепозитории), также привязывается к этому подкаталогу, поэтому apps/web и apps/api публикуются в отдельные проекты дашборда. history --format json содержит те же поля schema_version и cli_version, что и JSON сканирования.
В CI или на другой машине без браузера войдите с помощью токена: preflight auth login --token - читает его из stdin, либо задайте PREFLIGHT_TOKEN и выполните preflight auth login. В любом случае токен проверяется и сохраняется так же, как при входе через браузер; последующие команды читают сохранённые учётные данные, а не переменную.
Откройте любую неудачную проверку или проверку с предупреждением в опубликованном запуске, чтобы сгенерировать пошаговое исправление, адаптированное к обнаруженному стеку, с готовыми к копированию командами и кодом.
- Бесплатно включает 5 опубликованных запусков в месяц.
- Свой ключ: добавьте ключ API OpenAI или Anthropic в настройках дашборда, и публикация останется бесплатной и неограниченной (вы платите провайдеру напрямую).
- Управляемый ($5/мес): мы покрываем расходы на ИИ, а запуски неограничены, ключ API не требуется.