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 release exists before installing

First open GitHub release v0.1.6, then run the npm check below. If either is missing, use the source CLI and direct skill from the same checkout as documented in the repository; do not mix unreleased source with plugin-stable.

npm view @preflight-scout/[email protected] 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/[email protected] --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 --ref plugin-stable
codex plugin add preflight-scout@preflight-scout

Invoke $preflight-scout:preflight-scout.

Claude Code

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

Invoke /preflight-scout:preflight-scout.

plugin-stable moves only after npm publication, clean Linux and Windows installs, and the matching GitHub release succeed. After either install, restart the client and start a new task or session in the repository before invoking the skill.

UPDATES

Keep the CLI and agent skill on the same release.

Run the check before a full QA pass. The CLI reports its installed version, the skill supplies its baked compatibility version, and npm provides the public release metadata. The check does not install anything or send repository data.

The 0.1.0 CLI does not include this command. For that first update, verify the GitHub and npm release above, install the exact CLI, refresh the plugin, restart the client, and then run the compatibility check.

preflight-scout update-check --skill-version 0.1.6

CLI

npm install --global @preflight-scout/[email protected] --registry=https://registry.npmjs.org/
preflight-scout install-browser

Codex plugin

codex plugin marketplace upgrade preflight-scout

Claude Code plugin

claude plugin marketplace update preflight-scout
claude plugin update preflight-scout@preflight-scout

Restart Codex or Claude Code, open a new task or session, and rerun the compatibility check after a marketplace refresh.

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.