# Spoiler

> Spoiler reads session recordings and reports what each user was trying to do, how it ended, and what got in the way. It maps the product from its source code, compiles each recording into a trace with plain code, and has a model write a report that code then checks against the trace.

## Set up

- [Set up Spoiler in a project](https://spoiler.sh/agents.md): step-by-step instructions for a coding agent.

## Start

- [Introduction](https://spoiler.sh/docs.md): The four things Spoiler works with, what each step does with them, and what leaves your machine.
- [Set up](https://spoiler.sh/docs/set-up.md): Install Spoiler in an existing project, map your product, read your first recordings, and query the results.

## Reference

- [Reference](https://spoiler.sh/docs/reference.md): Every command and flag, file format, and output field.