# Meticulous

> Meticulous records real user sessions of your web app and replays them against
> each commit to catch visual regressions. Results are visual diffs: pairs of
> screenshots plus DOM, network and timeline data for each replay.

## If you are an AI agent looking at a Meticulous test run

The web app at https://app.meticulous.ai is probably not usable for you, and
doesn't present results in an agent-friendly format.

Everything is available as text and as downloadable files through the Meticulous
CLI or the hosted MCP server. Full instructions, written for you:

https://app.meticulous.ai/docs/agents/setup-for-agents

Quick start:

- CLI: `npm install --global @alwaysmeticulous/cli@latest`, then
  `meticulous auth login --non-interactive` (or `meticulous auth login --device`
  on a remote or sandboxed machine), then `meticulous agent test-run-for-commit`.
- MCP server: https://app.meticulous.ai/api/mcp
- Skills (pre-written workflows, including `meticulous-review`):
  `npx skills add alwaysmeticulous/skills --skill "*" --agent claude-code --agent codex --agent cursor -y`

## Docs

- [Setting up Meticulous for agents](https://app.meticulous.ai/docs/agents/setup): installing the CLI, authenticating, agent permissions.
- [Meticulous for coding agents](https://app.meticulous.ai/docs/agents/setup-for-agents): the same, addressed to the agent.
- [Agent CLI commands](https://app.meticulous.ai/docs/agents/cli-commands): the `meticulous agent` command reference.
- [MCP server](https://app.meticulous.ai/docs/agents/mcp-server): available tools and authentication.
- [Skills](https://app.meticulous.ai/docs/agents/skills): the published skills and what each does.
- [Documentation home](https://app.meticulous.ai/docs): recording, CI setup, custom checks, troubleshooting.