fresheyes

fresheyes is an open-source CLI tool that points a vision-capable AI agent at any web app and has it attempt a real user goal ("understand what this does and sign up") the way a skeptical newcomer would — by sight, not by reading the code. As it navigates, it narrates its confusion and decisions in real time, then produces a self-contained narrated HTML replay of the session plus a "rage-quit score" anchored to pre-generated, binary-checkable milestones. Beyond diagnosis, it generates tiered fixes — copy, layout, even SVGs — and in repo-aware mode proposes a reviewable change plan as a diff, never auto-editing. It supports both pre-login and logged-in reviews via locally saved browser sessions (credentials never touch the agent), and is extensible through markdown personas and MCP integrations like Figma and shadcn. The capstone: fresheyes built its own marketing site, then reviewed that site using itself.