Options
asgeirtj/system_prompts_leaks
Present multiple design options as a vertical stack of anchored turns
Overview of the Meticulous CLI tool and its global options. An agent skill from FlintSH/Flare.
MITAuto-check passed
Install Meticulous CLI
$ npx skills add FlintSH/Flare --skill meticulous-cli -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install FlintSH/Flare meticulous-cli --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/FlintSH/Flare.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/meticulous-cli .claude/skills/meticulous-cli && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "meticulous-cli" agent skill from https://github.com/FlintSH/Flare/tree/main/.agents/skills/meticulous-cli into .claude/skills/meticulous-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meticulous-cli", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/FlintSH/Flare/tree/main/.agents/skills/meticulous-cliType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add FlintSH/Flare --skill meticulous-cli -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install FlintSH/Flare meticulous-cli --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/FlintSH/Flare.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/meticulous-cli .agents/skills/meticulous-cli && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "meticulous-cli" agent skill from https://github.com/FlintSH/Flare/tree/main/.agents/skills/meticulous-cli into .agents/skills/meticulous-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meticulous-cli", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add FlintSH/Flare --skill meticulous-cli -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install FlintSH/Flare meticulous-cli --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/FlintSH/Flare.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/meticulous-cli .cursor/skills/meticulous-cli && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "meticulous-cli" agent skill from https://github.com/FlintSH/Flare/tree/main/.agents/skills/meticulous-cli into .cursor/skills/meticulous-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meticulous-cli", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/FlintSH/Flare.git --path .agents/skills/meticulous-cli--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add FlintSH/Flare --skill meticulous-cli -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install FlintSH/Flare meticulous-cli --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/FlintSH/Flare.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/meticulous-cli .gemini/skills/meticulous-cli && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "meticulous-cli" agent skill from https://github.com/FlintSH/Flare/tree/main/.agents/skills/meticulous-cli into .gemini/skills/meticulous-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meticulous-cli", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install FlintSH/Flare meticulous-cliInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add FlintSH/Flare --skill meticulous-cli -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/FlintSH/Flare.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/meticulous-cli .github/skills/meticulous-cli && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "meticulous-cli" agent skill from https://github.com/FlintSH/Flare/tree/main/.agents/skills/meticulous-cli into .github/skills/meticulous-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meticulous-cli", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add FlintSH/Flare --skill meticulous-cli -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install FlintSH/Flare meticulous-cli --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/FlintSH/Flare.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/meticulous-cli .opencode/skills/meticulous-cli && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "meticulous-cli" agent skill from https://github.com/FlintSH/Flare/tree/main/.agents/skills/meticulous-cli into .opencode/skills/meticulous-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meticulous-cli", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
meticulous-cli- GitHub stars
- 135
- Token cost
- ~1.4k tokens
- SKILL.md length
- 552 words
- Files
- 9 (incl. references)
- Skills in repo
- 10
- Repo updated
- First seen
- Licence
- MIT
At a glance
Overview of the Meticulous CLI tool and its global options. An agent skill from FlintSH/Flare.
- Asking about the meticulous CLI in general
- SKILL.md covers Invocation, Command Groups, Global Options and Authentication, plus 2 more sections
- Calls npm and npx; needs METICULOUS_API_TOKEN
- Available commands
What it does
Meticulous CLI is an agent skill from FlintSH/Flare. 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.
Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including reference files (for example `references/agent.md`, `references/auth.md` and `references/debug.md`).
The repository describes itself as: A modern, lightning-fast file sharing platform built for self-hosting. Created with support for ShareX, KDE Spectacle, Flameshot, and easy to set up. The licence is MIT.
When your agent uses it
- Asking about the meticulous CLI in general
- Available commands
- Global flags that apply to all commands
Example prompts
- “/meticulous-cli”
Requirements
- Node.js
- A credential in METICULOUS_API_TOKEN
What it can do on your machine
Read from SKILL.md and the folder at commit c910523. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npmnpx
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm and npx, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
METICULOUS_API_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Meticulous CLI loads about 1.4k tokens when it runs, and up to ~22k if it reads all its reference files. Until then it costs about 48 tokens; SKILL.md has 552 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from FlintSH/Flare at commit c910523, republished under its MIT licence (© FlintSH). 552 words, ~1,431 tokens.
Download SKILL.mdSave it as
.claude/skills/meticulous-cli/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.- name
- meticulous-cli
- description
- 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.
- user-invocable
- true
Meticulous CLI
The meticulous CLI records user sessions and replays them to catch visual regressions. It is installed as part of @alwaysmeticulous/cli.
Before starting, run the
meticulous-cli-updateskill 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.
Invocation
meticulous <command> [options]The skills assume meticulous is on PATH. The meticulous-cli-update skill installs it globally via npm install --global @alwaysmeticulous/cli@latest if missing. It can also be invoked as npx @alwaysmeticulous/cli when installed locally per-project.
Command Groups
| Command | Purpose |
|---|---|
agent | Read, analyse, and trigger test runs — the agent-facing commands, also exposed on the MCP server |
auth | Authenticate with Meticulous (login, whoami, logout, project selection) |
debug | Set up AI-ready debug workspaces for investigating replay diffs and replays |
download | Download sessions, replays, and test runs locally |
local | Find sessions relevant to the current branch's code changes |
project | Inspect the project you're authenticated against |
simulate / replay | Replay a recorded session against a URL |
schema | Output the CLI command schema as JSON (for agent/programmatic use) |
See the reference for each group for full option details:
- references/agent.md
- references/auth.md
- references/debug.md
- references/download.md
- references/local.md
- references/project.md
- references/simulate.md
- references/schema.md
Global Options
These options are accepted by every command:
| Option | Type | Default | Description |
|---|---|---|---|
--logLevel | string | info | Log verbosity: trace, debug, info, warn, error, silent |
--dataDir | string | ~/.meticulous | Directory where sessions, replays, and other data are stored |
--jsonArgs | string | — | Pass all options as a JSON string (useful for programmatic/agent invocation) |
--rawJson is a deprecated alias for --jsonArgs. --dryRun is not global — it is available only on the commands that perform actions (e.g. the ci / agent run-triggering and upload commands, and simulate); check the command's reference or meticulous schema <command>.
Show full SKILL.md (274 more words)Show less
Authentication
Commands authenticate via OAuth. The login token is stored on disk and reused across sessions — in an interactive terminal, a command that needs auth opens a browser sign-in automatically; without a TTY (the usual agent case) it fails and tells you to run meticulous auth login. Run meticulous auth whoami to see the current state. Project-scoped commands also need a default project, set at login or with meticulous auth set-project. See references/auth.md.
An API token (via --apiToken or the METICULOUS_API_TOKEN environment variable, scoped to a specific organization/project) is also supported, and is the way to authenticate in non-interactive contexts such as CI. Some agent platforms instead inject a bearer credential into outbound requests to app.meticulous.ai; that works too, and auth whoami reports it as credentials injected at request time.
MCP server
The agent commands are also exposed as tools on a hosted MCP server at https://app.meticulous.ai/api/mcp, so an MCP-enabled client (Claude Code, Cursor, Codex) can call them directly rather than shelling out to the CLI. Most read/analysis commands map to a get_<command> tool that returns the same data as the CLI command's --json output — for example agent test-run-diffs ⇄ get_test_run_diffs, agent dom-diff ⇄ get_dom_diff, and download session ⇄ get_session_data. The two mutating commands (upload-build, trigger-test-run) also have MCP tools, but not 1:1 — see references/agent.md for the full mapping, including that important difference. Connect with just the endpoint URL (browser OAuth on first use). The skills are written in terms of the CLI; substitute the matching tool where noted if you have the MCP server connected — but note MCP tools never infer git context (commitSha/baseSha/diff), unlike the CLI, so always pass those explicitly when using MCP.
Example
# Print schema for all commands (agent use)
meticulous schema
# Run a single replay locally
meticulous simulate --sessionId=<id> --appUrl=http://localhost:3000© FlintSH, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 8 other files (references) in .agents/skills/meticulous-cli of FlintSH/Flare.
- SKILL.md
- references/agent.md
- references/auth.md
- references/debug.md
- references/download.md
- references/local.md
- references/project.md
- references/schema.md
- references/simulate.md
Open the folder on GitHubat commit c910523
Compare with similar skills
Meticulous CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Meticulous CLI this skillFlintSH/Flare | 135 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Optionsasgeirtj/system_prompts_leaks | 69k | — | ~918 | Automated safety check: Pass | CC0-1.0 | |
| Options Strategy BacktestingHKUDS/Vibe-Trading | 35k | — | ~2k | Automated safety check: Pass | MIT | |
| Remove Option Or Flaggetsentry/sentry | 45k | — | ~3k | Automated safety check: Pass | Custom licence | |
| Options PayoffHKUDS/Vibe-Trading | 35k | — | ~6.8k | Automated safety check: Pass | MIT | |
| Add CLI Optionremotion-dev/remotion | 62k | — | ~1.5k | Automated safety check: Pass | Custom licence |
Similar skills
Options Strategy Backtesting
HKUDS/Vibe-Trading
Backtests multi-leg option strategies by synthesizing Black-Scholes prices from the underlying, simulating PnL, Greeks exposure and expiration for crypto and equity options.
- Official
Remove Option Or Flag
getsentry/sentry
Remove a Sentry option or FlagPole feature flag whose rollout is finished, in the correct PR order across sentry, getsentry, and sentry-options-automator.
Options Payoff
HKUDS/Vibe-Trading
Option P&L analysis methodology: payoff diagrams, breakeven calculation, multi-leg strategy visualization, and Greeks-based scenario analysis.
- Official
Add CLI Option
remotion-dev/remotion
Add a new Remotion CLI or config option by creating an AnyRemotionOption, registering CLI parsing, wiring config setters, and updating documentation.
Advanced Options Strategies
HKUDS/Vibe-Trading
Covers volatility-surface modeling (SABR, local volatility), dynamic Greeks management, calendar spreads, skew and volatility arbitrage, and market-making basics for options.
More from FlintSH/Flare
All 10 skills in this repoMeticulous Fix
FlintSH/Flare
Fix the visual diffs that have been reviewed and rejected on a Meticulous test run, following their review comments if given.
Meticulous Increase Coverage
FlintSH/Flare
Increase coverage for a Meticulous project by tracing specific under-covered files back to a real UI action in the codebase, driving that action with a real recorded browser session, and validating…
Meticulous Iterative Dev
FlintSH/Flare
Iterative frontend development loop using Meticulous for per-step visual validation.
Meticulous Review
FlintSH/Flare
Analyze a completed Meticulous test run — compare the diffs against the PR description to see what's expected, then focus on finding and flagging potential regressions.
Meticulous Simulate And Diff
FlintSH/Flare
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…
Meticulous Test
FlintSH/Flare
Run a Meticulous test run after implementing a frontend change, then hand off to the meticulous-review skill to classify each visual change as intended or unintended.
Questions about Meticulous CLI
What does Meticulous CLI do?
Overview of the Meticulous CLI tool and its global options. An agent skill from FlintSH/Flare. Meticulous CLI is an agent skill from FlintSH/Flare. Overview of the Meticulous CLI tool and its global options.
When should I use Meticulous CLI?
Meticulous CLI fits situations like: asking about the meticulous CLI in general; available commands; global flags that apply to all commands.
How do I install Meticulous CLI in Claude Code?
Run `npx skills add FlintSH/Flare --skill meticulous-cli -a claude-code`. Or copy the skill folder (.agents/skills/meticulous-cli in FlintSH/Flare) into .claude/skills/meticulous-cli in your project. Claude Code loads it when a task matches its description.
How do I install Meticulous CLI in Codex?
Run `npx skills add FlintSH/Flare --skill meticulous-cli -a codex`. Or copy the skill folder (.agents/skills/meticulous-cli in FlintSH/Flare) into .agents/skills/meticulous-cli in your project. Codex loads it when a task matches its description.
Can I use Meticulous CLI in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add FlintSH/Flare --skill meticulous-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/meticulous-cli, .gemini/skills/meticulous-cli, .github/skills/meticulous-cli and .opencode/skills/meticulous-cli in your project.
What does Meticulous CLI need to run?
Going by SKILL.md and its folder, Meticulous CLI needs the command-line tools its instructions call (npm and npx) and credentials named METICULOUS_API_TOKEN. Our summary lists: Node.js; A credential in METICULOUS_API_TOKEN.
Does Meticulous CLI access the network?
SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Meticulous CLI safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Meticulous CLI use?
Meticulous CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Meticulous CLI use?
About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 20k tokens, read only when the agent opens those files.
What are the alternatives to Meticulous CLI?
Skills that share tags, products or a category with Meticulous CLI: Options (asgeirtj/system_prompts_leaks, 69k stars), Options Strategy Backtesting (HKUDS/Vibe-Trading, 35k stars), Remove Option Or Flag (getsentry/sentry, 45k stars) and Options Payoff (HKUDS/Vibe-Trading, 35k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Meticulous CLI?
FlintSH (a GitHub user) maintains it in FlintSH/Flare, which has 135 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 6, 2026.
Source: FlintSH/Flare on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.