Ux Pilot

Your UX co-pilot — from idea to validated flow, in your terminal.

Install  ·  How it works  ·  Rules  ·  Try the demo  ·  Landing page

---

A Claude Code plugin that acts as a senior UX designer. It doesn't generate code blindly — it understands your product, challenges your choices, shows you the result in a live browser preview, and helps you iterate until the flow is validated.

What's New (v0.1.3)

• HTML Audit Report — audit results open as a styled HTML page in your browser with score, severity grouping, and category breakdown
• Fix Prompts (natural language) — each finding includes a no-coder-friendly prompt you can paste into Claude Code to fix the issue. No HTML tags, just plain instructions
• Persistent UX Brief — discovery saves ux-pilot/ux-brief.md in your project, updated as you make decisions
• Visual Audit with Playwright — if Playwright MCP is installed, the audit captures screenshots at 375px, 768px, and 1280px and analyzes the visual result. Falls back to static CSS analysis if not available
• 6 Mobile CSS Checks — detects tables without responsive wrapper, fixed widths > 500px, small touch targets (< 44px), small fonts (< 14px), nav without flex-wrap, and CSS widths without media queries
• Mobile Score Calibration — mobile findings now carry 1.5x penalty weight for more accurate scoring
• Screenshot References — findings from visual audit include clickable screenshot thumbnails in the HTML report
• Anti AI-Slop: No Emojis — the plugin now uses inline SVG icons instead of emojis (emojis render differently across OS/browsers)
• Finding Numbering — each finding shows its index (1/10, 2/10...) for easier tracking
• Back to Top — link at the bottom of the HTML report

Having issues updating? See Troubleshooting.

Optional: Playwright MCP for Visual Audit

For the best audit results, install Playwright MCP to enable screenshot-based visual analysis:

npm install -g @playwright/mcp

Then add it to your Claude Code MCP config (~/.claude/mcp.json):

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp"]
    }
  }
}

Without Playwright, the audit uses static CSS analysis only — still useful, but can't detect visual overflow or layout issues that only appear when the page is rendered.

Why ux-pilot?

Every AI tool generates the same generic output: Inter font, purple gradient on white, centered hero, done. ux-pilot exists to fix this.

Instead of jumping straight to code, it runs a structured discovery flow — asks about your product, users, and goals — then applies the right rules from 376 UX rules sourced from WCAG 2.1, Nielsen Norman Group, and Laws of UX.

What makes it different