INSTALLATION / TWO PARTS

Install Preflight Scout for Codex or Claude Code.

The skill tells Codex or Claude Code how to use Preflight Scout. The CLI reads the diff, runs Chromium, and saves the report.

Confirm the alpha exists before installing

The package is intentionally version-pinned. If npm does not return 0.1.0, use the source path documented in the repository instead.

npm view @preflight-scout/cli@0.1.0 version --registry=https://registry.npmjs.org/

Install the CLI

The CLI reads the diff, runs the approved browser mission, and writes the evidence packet. Node.js 22.13 or newer is required.

npm install --global @preflight-scout/cli@0.1.0 --registry=https://registry.npmjs.org/

Install Chromium

Chromium is installed separately so the npm package stays small.

preflight-scout install-browser

03 / AGENT SKILL

Add Preflight Scout to your coding agent

Codex

codex plugin marketplace add fenutech/preflight-scout
codex plugin add preflight-scout@preflight-scout

Invoke $preflight-scout:preflight-scout.

Claude Code

claude plugin marketplace add fenutech/preflight-scout
claude plugin install preflight-scout@preflight-scout

Invoke /preflight-scout:preflight-scout.

After either install, restart the client and start a new task or session in the repository before invoking the skill.

FIRST RUN

Use your signed-in coding agent, check the setup, then generate a plan for the current diff.

Codex

export PREFLIGHT_SCOUT_LLM_PROVIDER=codex-exec
preflight-scout init --no-llm --base origin/main
preflight-scout doctor --base origin/main --head HEAD --agent codex
preflight-scout analyze --base origin/main --head HEAD --open-report

Claude Code

export PREFLIGHT_SCOUT_LLM_PROVIDER=claude-exec
preflight-scout init --no-llm --base origin/main
preflight-scout doctor --base origin/main --head HEAD --agent claude
preflight-scout analyze --base origin/main --head HEAD --open-report

On PowerShell, replace the first line with $env:PREFLIGHT_SCOUT_LLM_PROVIDER = "codex-exec" or $env:PREFLIGHT_SCOUT_LLM_PROVIDER = "claude-exec". The remaining commands are the same.

init --no-llm creates the local config and ignore rules without spending a model call. These paths then use your authenticated Codex or Claude Code CLI for the current diff. API-provider alternatives are documented in the repository. Use local, preview, or staging targets with test accounts, and read the data and security boundaries before an authenticated run.