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.
Swipe sideways to see the whole screen.
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">
- now:
- 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.
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
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.
Privacy
What magnacoda.dev keeps, and why.
Visits
Visits are counted with Cloudflare Web Analytics (opens in a new tab). Totals are kept for which pages are viewed and from which countries, browsers, and referring sites the traffic originates. The analytics does not use cookies or follow you to other sites. Cloudflare, which hosts this site, does see your IP address to deliver the page, but this site does not retain it.
News checks from magnacoda
Each copy of magnacoda checks for news at most once a day. Only daily totals are kept: how many checks, from which versions. No IP addresses. You can turn the check off. magnacoda's manual explains how.
The form
When you send the form it delivers what you typed: your name, email, what you do if you provided it, your message, whether you asked for news, and whether you said you could be quoted, with the date for each. It's stored with Cloudflare (opens in a new tab), and a copy is emailed to me so I can respond.
The information is used by me to reply and to make magnacoda better. If you tick the "You can quote me on that!" box, I may quote that message on this site or elsewhere, anonymously or with your first name and what you do, but never with your email address or full name. It applies to that message only, and you can take it back at any time. None of your information is sold or shared.
Messages are deleted within two years of our last exchange. Your email address stays on the news list until you leave it.
The news list
News about magnacoda goes only to people who ask for it, with the "Send me news" box under "Share your thoughts" or "Get the news by email."
You will receive one email with a link, and nothing more is sent until you open it. What's kept: your email address and the date of your request. A request you never confirm is deleted within about a week after its link runs out. It's stored with Cloudflare (opens in a new tab). The emails are sent by Resend (opens in a new tab), which also keeps the addresses of people who confirmed. Every news email has a link to stop. None of your information is sold or shared.
When you confirm, the site also sets one small cookie on that device. It holds a value of true, which stops the site from showing the news subscribe button. It is never used to follow you. Clearing your cookies brings the button back.
Your data
To see or delete what's kept about you, or to leave the news list (every news email also has a link for that), use the form with the same email address, and say what you'd like. I'll answer by email to confirm before anything is deleted.