use-session-data
Use this workflow to get structured session data from Meticulous — the recorded user flows and network mocks that cover your code changes.
Step 1 — Find relevant sessions and download their data
Run the following command from the root of the git repository:
npx @alwaysmeticulous/cli local relevant-sessions --format=multi-file --minimum-times-to-cover-each-line=1
This will:
- Identify which recorded sessions exercise the code paths changed on your current branch.
- Download each session's data as a structured directory tree to
.meticulous/sessions/.
Options:
| Option | Type | Default | Description |
|---|---|---|---|
--format |
multi-file |
— | Set to multi-file to download each relevant session's data as a structured directory tree |
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