CLI Overview

The WCAG Audit CLI scans every route in your web application for accessibility issues and outputs fix prompts your AI coding tool can read directly.

What it does

Point the CLI at your project and it auto-discovers routes from your framework (Next.js, Vite, SvelteKit, Remix, Astro), launches a headless browser, runs 12 accessibility checkers on every page, and generates structured reports.

bash

cd my-nextjs-app
wcag-audit scan

Terminal output

✓ wcag-report.xlsx
✓ WCAG_FIXES.md
✓ 24 routes audited in 1m 42s

12 built-in checkers

Built-in accessibility checkers and what each one tests
Checker	What it tests
axe-core	100+ automated rules (contrast, ARIA, names/roles, headings, alt text)
Keyboard / focus	Tab walk, focus traps, visible focus, obscured focus
Viewport / reflow	320px reflow, 200% zoom, text spacing injection
Hover & on-focus	Tooltip dismiss, persist, hoverable content
Motion / flashes	Autoplay detection, 10-second timelapse flash analysis
Forms / errors	Invalid submit testing, error visibility, redundant entry
Pointer & gestures	24px minimum target size, multi-touch detection
Audio / video	Caption, subtitle, and description track presence
Accessible auth	CAPTCHA detection, paste-blocked fields, cognitive tests
SR shortcuts	Screen-reader shortcut uniqueness
Multi-page consistency	Navigation and label consistency across pages
AI vision review	Claude reviews 12 criteria from screenshots (included on paid plans)

Output files

By default, every scan generates these files. Enable more in .wcagauditrc:

Output files generated by a scan
File	Description	Default
`WCAG_FIXES.prompt.md`	One-shot fix prompt with Multi-Agent Protocol (Claude Code) and Linear Protocol (Cursor/Windsurf). Open in your AI editor and apply.	Yes
`wcag-report.xlsx`	Excel workbook with Summary, Coverage, and Issues sheets	Yes
`wcag-ai-fix.json`	Structured fix prompts per finding for programmatic AI tool consumption	No
`.cursor/rules/wcag-fixes.mdc`	Cursor project rules	No
`AGENTS.md`	Agent instructions for Claude Code	No
`wcag-coverage.json`	Machine-readable coverage stats	No
`wcag-report.json`	Full findings as JSON	No

Supported frameworks

Next.js (App Router and Pages Router)
Vite + React Router v6+
SvelteKit
Remix v2
Astro
Any deployed site via --url + BFS crawl
Manual routes file

Next step: Install the CLI and run your first scan →