Abilyo by WebAbility

CLI

Scan any website for WCAG accessibility issues from your terminal.

Install

npm install -g @webability/cli

Usage

# Scan a website
abilyo scan https://example.com
 
# Scan localhost
abilyo scan localhost:3000
 
# Output formats
abilyo scan example.com --format json
abilyo scan example.com --format html > report.html
abilyo scan example.com --format sarif > results.sarif
abilyo scan example.com --format csv
 
# CI mode — exit code 1 if issues found
abilyo scan example.com --exit
 
# Mobile viewport
abilyo scan example.com --viewport mobile
 
# Deeper scan (Pro plan)
abilyo scan example.com --deep
 
# Visual mode — open browser, see issues highlighted, preview AI fixes live
abilyo scan example.com --show
 
# Flow scan — multi-page user journey, one consolidated report
abilyo flow example.com/login

Visual Mode (--show)

Opens a real Chromium window with all issues highlighted as colored overlays. Includes:

  • Floating panel with severity filters, score, and full issue list
  • Click any issue → spotlight that element, dim everything else
  • Before/After preview for deterministic fixes
  • ✨ AI Fix button → DeepSeek V4 Flash generates 1–3 framework-aware alternatives per issue (brand-aligned, minimal, high contrast)
  • Preview live before applying — see the color/label change in real time
abilyo scan https://example.com --show

Note: Apply in --show mode only changes the live DOM. To persist fixes to source code, use the MCP server — your editor edits the actual files.

Flow Scan

Static scanners produce one report per page. With abilyo flow, click through your real journey (login → cart → checkout) and get one consolidated report with:

  • Issues deduplicated across all pages
  • Per-issue page count (×3 pages indicator)
  • Flow-specific issues (focus loss after navigation, missing skip links, inconsistent navigation)
abilyo flow https://example.com/login
# Browser opens — click through your journey, close when done

CI/CD Integration

GitHub Actions

name: Accessibility Check
on: [pull_request]
jobs:
  a11y:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm start &
      - run: npx @webability/cli scan http://localhost:3000 --exit --format sarif > results.sarif
      - uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: results.sarif

GitLab CI

accessibility:
  script:
    - npx @webability/cli scan $CI_ENVIRONMENT_URL --exit --format json > a11y.json
  artifacts:
    paths: [a11y.json]

Config File

abilyo init  # creates .webability.yml
.webability.yml
project: my-app
urls:
  - http://localhost:3000
  - http://localhost:3000/login
standard: WCAG2.1AA
threshold:
  critical: 0
  serious: 5

Authentication

abilyo login       # authenticate for Pro features
abilyo whoami      # check auth status
abilyo logout      # remove credentials

Output Formats

FormatFlagUse case
Table--format table (default)Terminal review
JSON--format jsonProgrammatic processing
CSV--format csvSpreadsheets
SARIF--format sarifGitHub Security tab
HTML--format htmlShareable reports

On this page