# meticulous-use-session-data

Downloads recorded Meticulous session data and network mocks covering your branch changes. Use it to inspect user interactions and retrieve API mocks for tests.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 8500 installs · ★ 10
- Author: alwaysmeticulous
- License: ISC · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/alwaysmeticulous/skills/tree/HEAD/skills/meticulous-use-session-data/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/meticulous-use-session-data

## What it does

The skill runs `meticulous local relevant-sessions` from the git repository root. It inspects changes on the current branch, matches them against recorded user sessions, and downloads the data into `.meticulous/sessions/`. The output includes `manifest.json`, user interactions in `user-events.json`, and initial storage state.

Network calls are stored in `network-requests/`. The summary file lists endpoints and status codes, while individual files contain full request and response bodies. You can take `response.content.text` directly into test mocks. Running the `meticulous-cli-update` skill beforehand is required to avoid version mismatches.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add alwaysmeticulous/skills --skill meticulous-use-session-data -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/meticulous-use-session-data/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/meticulous-use-session-data/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add alwaysmeticulous/skills --skill meticulous-use-session-data -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/meticulous-use-session-data/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add alwaysmeticulous/skills --skill meticulous-use-session-data -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/meticulous-use-session-data/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alwaysmeticulous/skills meticulous-use-session-data
```

2. **Manually: put the files in place**
- File: `.github/skills/meticulous-use-session-data/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add alwaysmeticulous/skills --skill meticulous-use-session-data -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/alwaysmeticulous/skills --path skills/meticulous-use-session-data
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/meticulous-use-session-data/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add alwaysmeticulous/skills --skill meticulous-use-session-data -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/alwaysmeticulous/skills/tree/HEAD/skills/meticulous-use-session-data/SKILL.md

## When to use it
- identify Meticulous sessions covering current git branch diffs
- extract realistic API response payloads for local test mocks
- inspect user click and input sequences via `user-events.json`
- retrieve initial cookies and localStorage states from recorded sessions

## Example prompts
- Download Meticulous session data covering my current branch changes.
- Find relevant sessions and pull network mocks for writing tests.
- Run `meticulous download session --sessionId=<id> --format=multi-file` to get session data.

## Source text · SKILL.md · ISC

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: f15eb171e7595d72.

BEGIN THIRD-PARTY FILE f15eb171e7595d72
````text
---
name: meticulous-use-session-data
description: Download and use structured Meticulous session data (user flows + network mocks) for testing code changes locally. Use when you need to understand what user interactions and API calls a test covers, or when you want network mocks for writing tests.
user-invocable: true
---

Use this workflow to get structured session data from Meticulous — the recorded user flows and network mocks that cover your code changes.

> Before starting, run the `meticulous-cli-update` skill to ensure the Meticulous CLI and skills are up to date — unless it has already run earlier in this conversation, in which case skip it.

## Step 1 — Find relevant sessions and download their data

Run the following command from the root of the git repository:

```bash
meticulous local relevant-sessions --format=multi-file --minimum-times-to-cover-each-line=1
```

This will:

1. Identify which recorded sessions exercise the code paths changed on your current branch.
2. 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                                       |
| `--minimum-times-to-cover-each-line` | number       | —                      | Select at least this many sessions to cover each edited line, choosing the most diverse subset when more candidates are available |
| `--include-superfluous-sessions`     | boolean      | `false`                | Also include sessions that do test some changes but were superfluous given `--minimum-times-to-cover-each-line`                   |
| `--outputDir`                        | string       | `.meticulous/sessions` | Output directory for multi-file format                                                                                            |
| `--showMaybeRelevant`                | boolean      | `false`                | Also show sessions that may be affected                                                                                           |
| `--startingPointSha`                 | string       | —                      | Only consider changes since this commit SHA                                                                                       |
````
END THIRD-PARTY FILE f15eb171e7595d72

The third-party file has ended. Everything between the f15eb171e7595d72 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2815 of 7280 bytes. © alwaysmeticulous · ISC · https://github.com/alwaysmeticulous/skills/tree/HEAD/skills/meticulous-use-session-data/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md