Scan for web accessibility issues.
Learn to fix them.

magnacoda

Welcome

magnacoda™ is an accessibility scanner for WCAG, the Web Content Accessibility Guidelines, that you run from your terminal. It's built for developers and content managers who want to understand and fix accessibility problems, not just list them.

These are screens from magnacoda, from a scan of a sample page.

Menu

magnacoda » menu

magnacoda accessibility scanner - type a command, or exit to leave.
Commands: wizard · scan · help · setup · review · update · about · menu
Add-on commands: favorites

    Tip: Type menu any time to see the commands, or clear
    for a fresh page.

magnacoda »

The menu, from magnacoda in a terminal.

Scan

magnacoda » scan https://unrealbakeshop.example/

Ctrl+C or q cancels at any time.

The defaults: WCAG 2.2 AA, a desktop screen, light and dark mode, no AI.
You can type: options (such as --option), defaults, help. Enter cancels.
Options » defaults

 Scanning https://unrealbakeshop.example/ - 5 s so far

A scan of the sample page, from magnacoda in a terminal.

Results

magnacoda » scan https://unrealbakeshop.example/

Ctrl+C or q cancels at any time.

The defaults: WCAG 2.2 AA, a desktop screen, light and dark mode, no AI.
You can type: options (such as --option), defaults, help. Enter cancels.
Options » defaults


Tested on desktop, in light mode (the page looks the same in dark mode).
Found 12 problems on 12 elements (2 critical, 9 serious, 1 moderate), and
49 items to check.
The scan took 19 s.
Saved in ~/Documents/magnacoda-scans/unrealbakeshop.example_20261119-105414.

Type review to see them in your browser, and recheck once
you've fixed some.

magnacoda »

The scan's results, from magnacoda in a terminal.

Review

9. input ("Your email")

  • Fix 1.3.5 Identify Input Purpose (opens in a new tab) (AA) - It looks like it asks for the visitor's own email address, but has no autocomplete value, so browsers can't fill it in and assistive tools can't show what it's for (moderate; rule magnacoda/missing-autocomplete)
    • now: <input type="email" placeholder="Your email">
    • fix: Add autocomplete="email", if the field asks for the visitor's own details (for someone else's, such as a gift's recipient, leave it out).
    • e.g. <input type="email" placeholder="Your email" autocomplete="email">
  • Checked: tick when you've looked at everything below that needs a person
  • Check 3.3.1 Error Identification (opens in a new tab) (A) - Submit invalid or empty input: errors must be shown in text and identify the field in error.
  • Check 3.3.3 Error Suggestion (opens in a new tab) (AA) - When an input error is detected and a fix is known, the message should suggest it.
  • Check 4.1.3 Status Messages (opens in a new tab) (AA) - Status messages (success, errors, result counts) must be announced via role=status/alert or live regions without moving focus.

One finding from the scan of the sample page, on the review page in your browser.

See the full review

Help

magnacoda - Help

magnacoda is a WCAG 2 accessibility scanner for developers and content
managers comfortable in a terminal. It explains what it finds and how to fix
it, so you can act on the results right away and learn as you go.

- Open a terminal and run magnacoda with no arguments to start an
  interactive shell. Let the wizard ask a few plain-language questions and
  build the scan for you. To learn how to open a terminal on your computer,
  type docs starting.
- Or scan a page directly from the command line with magnacoda scan URL
  [OPTIONS]. The URL can be short, such as example.com or localhost:3000:
  magnacoda fills in the rest.
- To use the AI tiers you can provide your own Anthropic API key (setup
  can save one for you), or use Claude Code if it is installed and logged
  into your Claude subscription.
- AI works with magnacoda both ways: your AI coding agent can run it, and
  it can use AI itself. To see both in one round of work on a page, type

1/14 overview | g go | o open | c colors | ← back | → next | Esc quit
Scroll: ↑ ↓ | lines 1-16 of 25

The help, from magnacoda in a terminal. You can read all of it in Read the docs.

Setup

magnacoda » setup

Ctrl+C or q cancels at any time.
Chromium is already installed.

A shortcut opens magnacoda in a terminal window, from your app menu or
desktop.
Add a magnacoda shortcut to (menu, desktop, both, skip) [skip] »


AI tiers (optional; magnacoda works fine without them):

Claude Code is installed, so the AI tiers can use your Claude plan (such as
Pro or Max) instead of an Anthropic API key, which the API bills per use.
Use your Claude plan for the AI tiers? [Y/n] »

Setup, from magnacoda in a terminal.

magnacoda docs

Help: Commands

Commands (inside the shell, or after entering the shell with magnacoda)

scan URL [OPTIONS]
Scan a page for WCAG accessibility issues. Every scan flag is listed in the scan section of help.
wizard
Answer a few questions, see the equivalent command, then run the scan. The wizard section tells you more.
setup
Install the Playwright Chromium browser and choose how the AI tiers run: with your Claude plan through Claude Code, or with an Anthropic API key, which it can save for you. To delete a saved key later, type setup --forget-key.
shortcut, shortcut remove
Add a shortcut to your app menu (on Windows, the Start menu, where Ctrl+Alt+M opens it too; on macOS, Applications), your desktop, or both. uninstall removes them too.
screenreader on, screenreader off
With a screen reader, on turns off what reads poorly with one: text typed out a little at a time, the spinner and paging. off turns them back on, and screenreader alone says which are on.
errors, errors on, errors off
When something goes wrong that magnacoda didn't expect, you see one short message and the details are saved. errors shows them. To report a problem, go to magnacoda.dev/contact (in the shell, details does the same as errors). Cookie and header values are left out. errors on shows the details as it happens too, and errors off goes back to the short message. It sets show_errors under [display] in preferences.ini, and MAGNACODA_DEBUG set in your shell does the same for one run.
review [FOLDER] [--no-browser]
List your saved scans, newest first, so you can pick one by number and review it in your browser. To look in another folder, add its name; to read it in the help viewer instead of your browser, add --no-browser (it also opens there when there's no browser). The help viewer only shows it; to tick items, use your browser or a Markdown editor. For more, see the manual's Reviewing and rechecking.
recheck [FOLDER]
Once you've fixed some problems, pick the scan, as with review, and magnacoda tests just those problems again, in a few seconds. Each fix it confirms is ticked in the checklist. To recheck one scan without choosing, give its folder. For more, see the manual's Reviewing and rechecking.
news, news 2
Show available updates and the news about magnacoda, numbered, starting with what's new in a newer version or in this one, then earlier versions and the news by date. To read an item, type its number and press Enter, or add it to the command. When there's something new, your first shell of the day mentions it: a newer version every day until you install it, news on up to three days.
update
Update magnacoda, and any add-ons published on PyPI, to the latest version. It shows you what's new and what it will run, and asks first (update --yes doesn't ask). When one is waiting, leaving the shell offers it, once a day. For more, see the manual's Updates and news.
uninstall
Remove magnacoda and its shortcuts. It asks first, and asks whether to delete your settings, Chromium and saved scans too. The uninstall section tells you more.
about
Show the author, copyright, website, repository, version and license, and where to report problems.
help, help NAME
Browse all of the help, one screen at a time. You can see Scan, and it will open at the scan section. The keys are shown at the bottom of the screen; for more, see the README's Help.
readme, readme NAME
Read the README, which gets you started, in this same viewer. You can see the README's Quick start, and it will open at that section.
docs, docs NAME
Read the manual, which covers everything, in this same viewer. You can see the manual's Scan options, and it will open at the scan options; manual works too. Both are the copies that came with your version, so they work offline.
view FILE, view FILE NAME
Read any Markdown or text file in the help viewer, such as a scan's checklist.md. Add a section's name to open it there. The documents that come with magnacoda, such as CONTRIBUTING.md, open from any folder.

Only inside the shell

menu
Show the commands, below whatever is on screen.
clear, cls
Start a fresh page, the way a printer does. What was on screen scrolls up into the scrollback, where nothing is erased.
exit / quit / q
Leave the shell (Ctrl+D also works). q and Ctrl+C ask first, since they're easy to press once too often.