smartspec audit

The primary command. Crawls a target URL, runs every enabled audit module against the crawled pages, and prints findings.

Synopsis

smartspec audit <url> [flags]

Flags

| Flag | Short | Default | Description | |---|---|---|---| | --format | -f | console | Output format. One of console, json, html, markdown, text, llm, xml. Only console and json are wired in v0.1; the rest ship in v0.2. | | --output | -o | stdout | File to write to. Default writes to stdout. | | --max-pages | -m | 250 | Hard cap on pages crawled in one run. | | --categories | — | all | Comma-separated category list, e.g. schema,mobile,security. See Audit rules › Overview. | | --quiet | -q | false | Suppress progress output. | | --verbose | — | false | Extra logging — useful when debugging an unexpected finding. | | --no-fixes | — | false | Omit the fix: line from each finding. Smaller output for raw signal-only consumers. | | --no-plugins | — | false | Skip user plugins, run only built-in modules. |

Examples

# Default audit, console output
smartspec audit https://example.com

# Limit crawl + JSON to disk
smartspec audit https://example.com -m 50 -f json -o audit.json

# Only schema + mobile checks, parsed downstream
smartspec audit https://example.com --categories schema,mobile -f json | jq '.findings[].rule'

# CI-friendly: no fixes, no plugins, just signal
smartspec audit https://example.com --no-fixes --no-plugins -f json

Exit codes

smartspec audit exits 0 when the audit completed, regardless of how many findings were produced. To fail a CI step on a critical finding, parse the JSON output:

smartspec audit https://example.com -f json | \
  jq -e '[.findings[] | select(.severity=="critical")] | length == 0'