meticulous-cli

An overview of the Meticulous command-line tool, which records real user sessions and replays them against a running application to catch visual regressions. Distributed as part of the @alwaysmeticulous/cli npm package, it is aimed at teams who want an automated way to detect unintended UI changes without hand-writing assertions. The skill serves as the general entry point for questions about the CLI as a whole, its command groups, and the global flags shared by every command.

Commands are invoked as meticulous <command> [options]. The tool is organized into groups: auth for authentication such as whoami and logout, debug for AI-ready workspaces to investigate replay diffs and replays, download for pulling sessions, replays, and test runs locally, local for finding sessions relevant to the current branch's code changes, project for inspecting the authenticated project, simulate/replay for replaying a recorded session against a URL, and schema for emitting the CLI command schema as JSON for programmatic or agent use. Each group has its own reference document for full option details.

Four global options apply to every command: --logLevel to control verbosity, --dataDir to set where sessions and replays are stored, --rawJson to pass all options as a JSON string, and --dryRun to preview what a command would do without making changes. Authentication is via OAuth, with a login token stored on disk and reused across sessions; interactive commands open a browser sign-in automatically when needed. For non-interactive contexts such as CI, an API token can be supplied through --apiToken or the METICULOUS_API_TOKEN environment variable. A companion update skill installs or refreshes the CLI so it is current before other skills run.