CLI Usage
The CLI mode lets you run examinations from the terminal without the web UI. Useful for automation, scripting, and CI pipelines.
Basic usage
npm run examine -- <url> [browser] [policy]
Examples
# Examine with Chromium (default)
npm run examine -- https://example.com
# Examine with Firefox on balanced policy
npm run examine -- https://example.com firefox balanced
# Examine with Chromium in diagnostic mode
npm run examine -- https://example.com chromium diagnostic
# Pipe output to a file
npm run examine -- https://example.com > report.json
Arguments
| Position | Name | Default | Description |
|---|
| 1 | url | required | Target URL (http or https) |
| 2 | browser | chromium | Browser ID |
| 3 | policy | strict | Safety preset (strict, balanced, diagnostic) |
Browser IDs
| ID | Browser |
|---|
| chromium | Playwright-bundled Chromium |
| chrome | Google Chrome |
| edge | Microsoft Edge |
| firefox | Playwright-bundled Firefox |
| webkit | Playwright-bundled WebKit |
| brave | Brave Browser |
| opera | Opera |
| vivaldi | Vivaldi |
Output
The CLI prints the complete MatrixReport as JSON to stdout. Artifacts are written to runs/<run-id>/ as usual.
Exit codes
| Code | Meaning |
|---|
| 0 | Run completed (may include browser failures) |
| 1 | Usage error (missing URL) |