gh-a11y
Audit web accessibility
TLDR
View documentation for the original command
SYNOPSIS
gh a11y [-R, --repo [<REPOSITORY>]] [--json] [--jq <expression>]
PARAMETERS
-R, --repo [<REPOSITORY>]
Repository to audit in OWNER/REPO format (defaults to current)
--json
Output report in JSON format instead of human-readable
--jq <expression>
Filter JSON output using jq expression
DESCRIPTION
gh-a11y is a GitHub CLI extension that audits repositories for accessibility issues. It scans open issues and pull requests labeled with common accessibility tags like a11y, accessibility, wcag, or accessibility-bug. The tool generates a report summarizing the count of open a11y issues, grouped by label, with direct links for quick review. This helps maintainers track and prioritize accessibility debt, promoting inclusive development.
Run it in any GitHub repository to get instant feedback. Supports JSON output for integration into CI/CD workflows or custom scripts. Requires GitHub CLI authentication and works best on public or accessible repos. Ideal for teams committed to WCAG compliance and better user experiences for all.
CAVEATS
Requires GitHub CLI v2.0+ and authentication via gh auth login. Only detects issues/PRs with predefined accessibility labels; misses unlabeled issues. Limited to GitHub-hosted repos.
INSTALLATION
Run gh extension install github/gh-a11y then gh extension upgrade gh-a11y for updates.
LABELS CHECKED
Scans for: a11y, accessibility, accessibility-bug, wcag, type:accessibility.
HISTORY
Released by GitHub in 2023 to support accessibility tracking amid growing a11y focus in open source.


