hwatu — Claude Code MCP server for UI verification
hwatu lets coding agents inspect web pages in headless WebKit, query the DOM, capture screenshots, and compare images. Use it to check frontend changes before handing them off.
Open on GitHubWhat hwatu does
The server exposes page checks to an agent: it can evaluate a DOM expression, capture a screenshot, and compare that image with another session. hwatu check combines page loading, evaluation, and a screenshot; hwatu verify runs a project check from a configuration file. Results can include console and loading details.
Sessions run without a visible window by default. Use hwatu focus <id> to bring an existing session onscreen for a person, with its state intact. Installation needs the static binary and the distro’s webkitgtk-6.0; the installer checks for that library, so the browser cannot start without it. Connect an agent with hwatu setup, or configure the MCP server manually.
What it helps with
- compare page screenshots before and after a change
- read a page title through the DOM
- capture a screenshot and console details in one call
- hand a headless browser session to a person
Example prompts for the agent
- Check
localhost:5173, read its title from the DOM, and save a screenshot to/tmp/after.png. - Compare sessions
2and1, saving the difference heatmap to/tmp/heat.png. - Verify the settings page change, then bring the browser session onscreen for a manual check.
How to install hwatu
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about hwatu
How do I install hwatu in Claude Code?
Run curl -fsSL https://raw.githubusercontent.com/hongnoul/hwatu/main/scripts/install.sh | bash, then connect the client with hwatu setup --client claude --scope project.
What does hwatu do?
It provides browser-based checks for coding agents: DOM evaluation, screenshots, and image comparisons through MCP or its CLI.
What library does hwatu need?
It needs the distro’s webkitgtk-6.0 library. The installer checks for it.
