Show HN: Shotlist – Make your AI agent prove its work with real screenshots Shotlist, a new open-source tool, lets developers capture reproducible screenshots of web pages, terminal windows, and CLI sessions as code, regenerating them on demand to prevent documentation drift. The tool supports multiple shot types and integrates with CI pipelines for automated visual drift checking. Screenshots for your docs — as code. One committed shot list captures your web pages, your real terminal windows, and stateful CLI sessions — and regenerates them all with a single command. The problem the-problem Quickstart quickstart One shot list, four kinds of shot one-shot-list-four-kinds-of-shot Use cases use-cases Proof reports & pipelines proof-reports--pipelines Why shotlist, and not the others why-shotlist-and-not-the-others How it works how-it-works Use with Claude use-with-claude Commands commands Develop develop Documenting a feature means launching the app, clicking to the right state, screenshotting, naming the file, and embedding it — every time the UI changes. The screenshots drift out of date the moment you ship, and nobody notices until they're embarrassingly wrong. shotlist makes them reproducible : describe how to start your app and what to shoot once, in a committed .shotlist.yaml , then regenerate the whole set on demand — locally or in CI. Same config + same app state → same screenshots. pip install shotlist installs the shotlist command playwright install chromium one-time browser download shotlist init writes a starter .shotlist.yaml shotlist run boots your app, captures every shot, tears it all down output: dir: docs/screenshots readme: README.md optional: splice