uxlint

Audit any website's UX the way a design-literate reviewer would: contrast, tap targets, type scale, colour discipline, scan patterns, landmarks. Every finding comes with a prescriptive fix an agent (or a human) can apply directly. It's designed to sit in a coding agent's loop (MCP) and be iterated against until green.

A real run, start to finish: audit_url → Grade B, a 2.39:1 contrast error and three CTAs in three different accent hues → the fix → verify_fix → Grade A. Every number in it came back from the tools; only the waiting was cut.

This is the CLI: a small, single static Rust binary. It drives a Chrome/Chromium you already have installed over the DevTools protocol (no Node, no Playwright, no headless-browser download), captures what a page looks and reads like, and sends that to uxlint's hosted server, which does the actual grading. The rules engine, the calibrated thresholds, and the LLM judge all live server-side, so the client never needs updating when a rule changes.

┌──────────────────────────┐        POST /v1/audit {snapshots}        ┌──────────────────────────┐
│ uxlint (this binary)     │ ───────────────────────────────────────▶ │ uxlint-server (hosted)    │
│ drives YOUR Chrome (CDP) │ ◀─────────────────────────────────────── │ rules engine + LLM judge  │
└──────────────────────────┘        report {findings + fixes}         └──────────────────────────┘

Install

curl -fsSL https://uxlint.net/install.sh | sh    # detects OS/arch, verifies checksum

Or with mise — its github backend pulls the matching build from GitHub Releases, verifies it, and updates on mise up:

mise use -g "github:uxlint-net/uxlint-cli[rename_exe=uxlint]@latest"

or pin it in a project's mise.toml:

[tools]
"github:uxlint-net/uxlint-cli" = { version = "latest", rename_exe = "uxlint" }

Or build from source (needs a recent stable Rust toolchain and a Chrome/Chromium on PATH):

git clone https://github.com/uxlint-net/uxlint-cli && cd uxlint-cli
cargo build --release
./target/release/uxlint --version

Quickstart

uxlint auth login                                        # opens your browser, saves a token
uxlint audit --base https://your-site.com --routes /,/pricing

First time auditing your own project? uxlint init picks (or creates) a site to attach reports to and writes a uxlint.toml so every future audit in this directory just works:

uxlint init
uxlint audit --base http://localhost:5173 --routes /,/pricing

Exit code 1 on findings above the configured severity → drop it straight into CI (see .github/workflows/ for a template, or the uxlint-net/uxlint-action GitHub Action).

Hiding elements from an audit (uxlint-hide)

Some on-page chrome isn't product UI and shouldn't be judged: a dev/staging environment banner, a "DEV" marker, a debug toolbar, a Storybook/preview affordance. Add the class uxlint-hide to any such element and the audit removes it — it's display:none from first paint, so it never appears in a screenshot and is invisible to the collector (it seeds no findings):

<div class="env-banner uxlint-hide">STAGING</div>

The class is inert on your real site — it does nothing unless the audit is running, because the stylesheet that hides it (.uxlint-hide { display: none !important; }) is injected only by uxlint's browser, before the page's own scripts run. Style your element however you like the rest of the time. It applies in every capture path — the crawl, goal-walk tests, and fix previews.

MCP (use it from a coding agent)

Claude Code, one command:

/plugin marketplace add uxlint-net/uxlint-cli
/plugin install uxlint@uxlint

That installs the uxlint MCP server and, if the CLI isn't already on your PATH, fetches the matching version once with the same checksum-verifying installer as above — so /plugin update updates the CLI underneath it too. No Node needed: it downloads one static binary (verified against a published checksum) and drives the Chrome you already have.

Any other agent — one line (the npm package fetches the binary for your platform, verifies the checksum published beside it, and hands over). This is the only route that needs Node 18+, for npx itself; if you'd rather not, install the binary with the line at the top and register that:

claude mcp add uxlint -- npx -y @uxlint-net/uxlint mcp

Or, for a client that reads a JSON config:

{ "mcpServers": { "uxlint": { "command": "npx", "args": ["-y", "@uxlint-net/uxlint", "mcp"] } } }

uxlint is also in the MCP Registry as io.github.uxlint-net/uxlint, for clients that browse it. Already have the CLI? uxlint mcp install registers it directly, no npx wrapper.

There is no token to set up first: ask your agent to audit something while signed out and it hands you a sign-in link that mints and saves the token for you (UXLINT_API_KEY is for CI, which has no browser).

Five tools: audit_url (full audit, graded verdict + action plan), verify_fix (recheck one rule on one page after an edit), get_shot (fetch a finding's annotated screenshot), ux_guidance (best-practice guidance to read before building UI), and lint_feedback — opt-in and off by default (§ Privacy) — one tool for three kinds of signal: whether a finding was useful, a lint uxlint is missing, or a component library it didn't recognise. The agent audits, reads the fixes, edits, and re-audits until green.

Privacy & trust

This CLI runs on your machine and drives a real browser against real pages, so it's fair to ask exactly what it captures and where it goes. What we can tell you, because it's what the code in this repo actually does:

• The collector is baked in and readable. It's compiled into this binary (include_str! of assets/collector.js), so uxlint --version pins the exact capture code and the server can't inject anything at run time. Everything it captures is page geometry, visible text, computed styles, and screenshots. For an embedded <iframe> it records the src's host only — never the full embed URL, which can carry session ids and tokens in its query string. It never reads your source code or your filesystem beyond uxlint.toml. It does read a little project provenance and send it with the report: your current git commit sha and branch name (git rev-parse), the machine's hostname, and, in GitHub Actions, the repo/PR/commit link. Set UXLINT_RUNNER to override the hostname.
• Secret & PII redaction is best-effort, not a guarantee. Before anything is uploaded, the collector masks text that looks like a token, API key, password, or email address in captured page text, and redacts the same patterns from console logs and native dialog messages. All channels share one pattern list (assets/redact.js), so they can't drift. Screenshots get an extra pass right before capture: every form field value is masked (passwords blanked, other inputs replaced with dots) and pattern-matched secrets in on-page text are scrubbed, so typed data and displayed keys don't land in the image. That pass reaches into shadow DOM (including closed roots, via an attachShadow interceptor) and same-origin iframes, and covers a cross-origin iframe with an opaque box since its pixels can't be redacted. But redaction is pattern-based, and a screenshot is still pixels: arbitrary displayed content that no pattern catches (a customer name on the page, order data), split-up values, and anything drawn into images or <canvas> can still slip through. Credentials you pass with --header/--storage/--login-* drive your browser only and are never sent to uxlint's server.