What Is ProofShot? Visual Verification for AI Coding Agents

Question

What Is ProofShot?

ProofShot is an open-source CLI that gives AI coding agents a real browser to verify their UI work. It records video, captures screenshots, and collects errors — then bundles everything for human review.

Last verified: March 29, 2026

Key Specs

Feature	Detail
Type	Open-source CLI
Repository	AmElmo/proofshot
Package	npm: proofshot
Language	TypeScript
Browser	agent-browser (headless Chromium)
Agents	Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Copilot
Cloud required	No — fully local

How It Works

Three-step workflow:

# 1. Start recording
proofshot start --run "npm run dev" --port 3000

# 2. Agent drives the browser
agent-browser open http://localhost:3000
agent-browser click @e5
agent-browser screenshot ./proofshot-artifacts/step-1.png

# 3. Stop and generate report
proofshot stop

Output includes video recording (.webm), screenshots, an interactive HTML viewer, and error logs from 10+ backend languages.

Why It Matters

AI coding agents write code blind — they can’t see if the UI they built actually works. ProofShot closes this feedback loop, potentially reducing manual QA time by 30-40% for UI work.

The proofshot pr command uploads proof artifacts directly to GitHub PRs, giving reviewers visual evidence alongside code diffs.

Answer 1