create-scout

The guided setup wizard for Scout — an AI-agent QA toolkit that drives real browsers, records QA sessions (Playwright trace, video, network HAR, console), and renders self-contained verification reports.

One command to get Scout and its browser runtime set up — no flags to remember. Every step just shells out to the same published commands you could run by hand, so there's no magic and nothing bespoke to uninstall. Agent integration (skills, Claude Code plugin) is deliberately left to you: after setup the wizard prints the exact commands to run.

Use

npm create scout
# or:  npm init scout  ·  pnpm create scout  ·  yarn create scout

You'll get a checklist (space toggles, enter confirms). Recommended items are pre-selected:

| Step | Default | What it runs | | --- | --- | --- | | Install the scout command globally | ✓ | npm i -g @clipboard-health/scout-cli | | Install the browser runtime (Chromium) | ✓ | scout install | | Also install scout-browser globally | — | npm i -g @clipboard-health/scout-browser | | Also install the scout-viewer viewer globally | — | npm i -g @clipboard-health/scout-ui |

Installing the CLIs globally puts scout, scout-browser, and scout-viewer on your PATH so day-to-day use drops the npx prefix. The wizard never installs the plugins itself — once setup completes it prints the commands (Claude Code /plugin …, Cursor / Codex marketplace) so each agent's own mechanism does the work.

Non-interactive

In a pipe or CI (no TTY), the wizard prints the exact commands to run instead of prompting — safe to inspect before executing.

After setup

Add the agent integration yourself (one-time):

# Claude Code: /plugin marketplace add ClipboardHealth/scout  then  /plugin install scout@scout-marketplace

Then record a session:

scout session start --name "checkout"   # start a recorded session (prints an id)
scout run ./step.js --session <id> --step "open"
scout session end <id>                  # -> ~/.scout/sessions/<id>/report.html
scout-viewer                            # browse recorded sessions

Using a coding agent? Try /scout:verify (plan QA for your changes) or /scout:session (record a flow) in Claude Code / Cursor / Codex. See examples/ in the repo for runnable demos.

Related packages

• @clipboard-health/scout-cli — the scout session orchestrator.
• @clipboard-health/scout-browser — one-off automation engine.
• @clipboard-health/scout-ui — the scout-viewer session browser.

MIT · source