axle-cli
v1.0.2
Published
a11y / WCAG 2.2 AA accessibility CI — scan URLs for accessibility violations with axe-core, generate AI code fixes via Claude. Built for EAA 2025, ADA Title III, Section 508, EN 301 549.
Maintainers
Readme
axle-cli
Command-line accessibility compliance runner. Scans a URL for WCAG 2.1 / 2.2 AA violations with axe-core and optionally generates surgical code-fix suggestions using Claude Sonnet.
npx axle-cli scan https://example.com \
--fail-on serious \
--with-ai-fixes \
--markdown-out a11y.md- No signup. Run locally, in CI, on a cron.
npx axle-cli scan --helpfor all options.- Works behind any host: localhost, Vercel preview, Netlify preview, production.
- Produces a machine-readable JSON report and a human-readable markdown report.
- Exits non-zero at or above
--fail-onseverity (perfect for CI).
Why not just use axe-core directly?
axe-core tells you what's wrong. axle-cli also proposes the fix, writes the PR comment, tracks regressions, and ships artifacts your compliance officer needs (accessibility statement, audit trail, badge). Same engine underneath, a workflow around it.
Not a compliance certificate
Remediation assistance only. Automated tools catch ~57% of WCAG issues. Human review recommended for full conformance.
Telemetry
At the end of each scan, axle-cli sends a single anonymous ping
({ source: "axle-cli", event: "scan_complete" }) to
axle-iota.vercel.app/api/track
so we can see how much the CLI is being used. No URL, no report contents,
no user identifiers. Disable with AXLE_NO_TELEMETRY=1.
Learn more: axle-iota.vercel.app · GitHub
