# ProofShot

> A CLI tool that lets AI coding agents prove their work with video recording, error logs, and proof artifacts every time they ship code.

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.*

## Features
- Video recording of browser sessions
- Automatic dead-time trimming
- Browser console error capture
- Server log scanning with pattern matching
- Interactive standalone HTML viewer
- Synchronized video and action timeline
- Screenshot capture
- PR-ready SUMMARY.md generation
- Visual diff comparison against baselines
- Agent-agnostic design
- MCP-compatible agent support
- MIT open-source license

## Integrations
Claude Code, Cursor, Codex, Gemini CLI, Windsurf, npm, Chromium

## Platforms
CLI

## Pricing
Open Source

## Links
- Website: https://proofshot.argil.io
- Documentation: https://github.com/AmElmo/proofshot#readme
- Repository: https://github.com/AmElmo/proofshot
- EveryDev.ai: https://www.everydev.ai/tools/proofshot