meticulous-cli-local
meticulous local
Commands for working with Meticulous data relative to your local git branch.
local relevant-sessions
meticulous local relevant-sessions [options]
Purpose: Find recorded user sessions that exercise the code paths changed on your current branch (relative to the merge-base with the base branch). For each session, also returns the baseReplayId — the replay of that session on the merge-base commit — so you can immediately diff your local changes against it.
Options:
| Option | Type | Default | Description |
|---|---|---|---|
--apiToken |
string | — | Meticulous API token; falls back to METICULOUS_API_TOKEN env var |
--showMaybeRelevant |
boolean | false |
Also show sessions that may be affected by the changes |
--startingPointSha |
string | — | Only consider changes since this commit SHA. The merge-base is still used to find the base test run, but the diff is computed from startingPointSha instead. Use in agentic loops to scope each iteration to only the latest changes. |
More from alwaysmeticulous/skills
meticulous-cli
Overview of the Meticulous CLI tool and its global options. Use when asking about the meticulous CLI in general, available commands, or global flags that apply to all commands.
28test-with-meticulous
Run after implementing any frontend change to verify its visual impact. Triggers a Meticulous test run, then inspects screenshot diffs to classify each visual change as intended or unintended. Use this before marking a frontend task as complete.
26meticulous-simulate-and-diff
Run a Meticulous session simulation against a live URL and analyze the visual output — either by inspecting screenshots directly (quick-check mode) or by comparing pixel and HTML diffs against a base replay. Use when checking whether a code change has introduced visual regressions for a specific session.
23meticulous-cli-schema
Meticulous CLI schema command for outputting the full CLI command structure as JSON. Use when you need to programmatically inspect available commands and their options, or when building tooling that drives the Meticulous CLI.
20meticulous-cli-download
Meticulous CLI download commands for fetching recorded sessions, replays, and test runs to the local data directory. Covers `meticulous download session`, `meticulous download replay`, and `meticulous download test-run`.
20meticulous-cli-auth
Meticulous CLI authentication commands. Use when logging in, checking who is authenticated, or logging out of the Meticulous CLI. Covers `meticulous auth whoami` and `meticulous auth logout`.
20