ProofShot: Give AI Coding Agents Eyes to Verify UI They Build

2026-03-24T11:32:05.743Z·2 min read

ProofShot is an open-source, agent-agnostic CLI tool that closes this loop by giving AI coding agents a verification workflow. It records video proof, captures screenshots, collects console and ser...

The Blind Spot in AI-Driven Development

AI coding agents like Claude Code, Cursor, Codex, and GitHub Copilot have transformed software development — but they share a critical limitation: they can't see what they build. Agents write UI code blindly, unable to verify that the result looks right, functions correctly, or throws no errors.

ProofShot is an open-source, agent-agnostic CLI tool that closes this loop by giving AI coding agents a verification workflow. It records video proof, captures screenshots, collects console and server errors, and bundles everything for human review.

Three-Step Workflow

The system follows a simple start → test → stop pattern:

proofshot start --run "npm run dev" --port 3000 --description "Login form verification"

# 2. Test — the AI agent drives the browser
agent-browser snapshot -i      # See interactive elements
agent-browser open http://localhost:3000/login
agent-browser fill @e2 "test@example.com"
agent-browser click @e5
agent-browser screenshot ./proofshot-artifacts/step-login.png

# 3. Stop — bundle video + screenshots + errors into proof artifacts
proofshot stop

What You Get

Each verification session produces a timestamped folder with:

session.webm — Full video recording of the browser session
viewer.html — Standalone interactive viewer with scrub bar, timeline, and log tabs
SUMMARY.md — Markdown report with errors, screenshots, and video
*step-.png** — Screenshots captured at key moments
session-log.json — Action timeline with timestamps
server.log and console-output.log — Server and browser errors

PR Integration

One of ProofShot's most powerful features is GitHub PR integration. Running proofshot pr automatically finds all sessions recorded on the current branch, uploads screenshots and video, and posts a formatted comment with inline media directly to the pull request.

Agent Support

ProofShot supports all major AI coding agents:

Claude Code
Cursor
Codex
Gemini CLI
Windsurf
GitHub Copilot
Any agent that runs shell commands

The proofshot install command automatically detects installed AI coding tools and installs the appropriate skill files. No vendor lock-in, no cloud dependency — everything runs locally.

Comments0