ProofShot

ProofShot is an open-source CLI tool that wraps your dev server and records everything an AI coding agent does — capturing video, console errors, server logs, and screenshots into a shareable proof bundle. It is agent-agnostic, working with Claude Code, Cursor, Codex, Gemini CLI, Windsurf, and any MCP-compatible agent. Built under the MIT license, ProofShot installs globally via npm and requires no per-agent configuration after the initial setup.

• Video Recording — Run proofshot start --run "npm run dev" to launch your dev server, open headless Chromium, and begin recording the full browser session with automatic dead-time trimming.
• Error Detection — Captures browser console errors and scans server logs with pattern matching for JavaScript, Python, Go, Rust, and more, surfacing issues automatically at session end.
• Interactive Timeline Viewer — Generates a standalone HTML file with synchronized video playback, screenshots, and an interactive action timeline with element labels — no server required to view.
• PR-Ready Artifacts — Produces a SUMMARY.md and formatted output ready to paste into pull requests, plus visual diff comparison against baselines.
• Agent-Agnostic Integration — Install once with proofshot install and every supported AI coding agent gains visual verification skills automatically.
• Three-Command Workflow — Use proofshot start, proofshot exec, and proofshot stop to wrap any agent session; each exec action (navigate, click, fill, screenshot) is logged to the timeline.
• Open Source (MIT) — The full source is available on GitHub under the MIT license, making it freely usable and extensible for any team or workflow.