ProofShot: CLI for AI Agents to Verify UI Code with Browser Recording
What ProofShot Does
ProofShot is a CLI tool that gives AI coding agents visual verification capabilities. It allows agents to see what the UI they build actually looks like in the browser, detect layout issues, and capture console errors.
How It Works
The tool operates through three main commands:
proofshot start --run "npm run dev" --port 3000- Launches your dev server, opens headless Chromium, and starts recording video- Your AI agent then executes actions like
proofshot exec navigate "http://localhost:3000"andproofshot exec screenshot "homepage"to navigate, click, fill forms, and take screenshots proofshot stop- Collects errors, stops recording, trims dead time, and generates proof artifacts
Output and Features
ProofShot generates a standalone HTML file containing:
- Video playback of the browser session synced with an action timeline
- Screenshots taken during the session
- Element labels for each action
- Browser console errors captured during the session
- Server logs scanned with pattern matching for JavaScript, Python, Go, Rust, and other languages
- PR-ready artifacts including SUMMARY.md and formatted output for pull requests
- Visual diff comparison against baselines
Technical Details
The tool is:
- Built on agent-browser from Vercel Labs (described as "far better and faster than Playwright MCP")
- Not a testing framework - the agent doesn't decide pass/fail, it just provides evidence
- Agent-agnostic - works with Claude Code, Cursor, Codex, Gemini CLI, Windsurf, and any MCP-compatible agent
- Packaged as a skill so AI agents know exactly how it works
- Open source with MIT license
Installation and Setup
$ npm install -g proofshot
$ proofshot install
The tool automatically trims dead time from recordings, so you see only what the agent actually did, not idle waiting periods.
📖 Read the full source: HN LLM Tools
👀 See Also
Introducing NetViews 2.3: A Robust Network Diagnostic Tool for macOS
NetViews 2.3 combines host discovery, Wi-Fi insights, and real-time monitoring with a streamlined GUI for better network diagnostics on macOS.
OpenClaw Kubernetes Operator with Embedded Ollama Support
A community member has created an OpenClaw Kubernetes operator that includes embedded Ollama support, allowing AI agents to run with local models in the same namespace. The setup includes installation commands, configuration details for both local and cloud Ollama models, and dashboard access instructions.
Claude Code Limiter: Self-Hosted Rate Limiter for Shared Claude Code Subscriptions
claude-code-limiter is a self-hostable tool that adds per-user rate limits to shared Claude Code subscriptions, featuring per-model quotas, credit budgets, sliding 24h windows, time-of-day rules, and a real-time dashboard.
Solitaire: Open-Source Identity Infrastructure for AI Agents
Solitaire is an open-source identity infrastructure for AI agents that focuses on improving how agents work with users over time, not just recall. It's local-first, model-agnostic, and available via pip install solitaire-ai.