Meticulous CLI 工具及其全局选项的概述。当询问有关 meticulous CLI 的一般信息、可用命令或适用于所有命令的全局标志时使用。
Meticulous CLI
meticulous CLI 记录用户会话并重放它们以捕获视觉回归。它作为 @alwaysmeticulous/cli 的一部分安装。
开始之前，运行
meticulous-cli-update技能以确保 Meticulous CLI 是最新的——除非它已经在此对话中较早运行过，在这种情况下跳过它。
调用
meticulous <command> [options]
这些技能假设 meticulous 在 PATH 上。meticulous-cli-update 技能通过 npm install --global @alwaysmeticulous/cli@latest 全局安装它（如果缺失）。它也可以作为 npx @alwaysmeticulous/cli 在项目本地安装时调用。
命令组
| 命令 | 用途 |
|---|---|
agent |
读取、分析和触发测试运行——面向代理的命令，也在 MCP 服务器上暴露 |
auth |
使用 Meticulous 进行身份验证（登录、whoami、注销、项目选择） |
debug |
设置 AI 就绪的调试工作区，用于调查重放差异和重放 |
download |
在本地下载会话、重放和测试运行 |
local |
查找与当前分支代码更改相关的会话 |
project |
检查您已认证的项目 |
simulate / replay |
针对 URL 重放记录的会话 |
schema |
以 JSON 格式输出 CLI 命令模式（供代理/程序化使用） |
有关每个组的完整选项详细信息，请参阅参考：
- references/agent.md
- references/auth.md
- references/debug.md
- references/download.md
- references/local.md
- references/project.md
- references/simulate.md
- references/schema.md
全局选项
以下选项被每个命令接受：
| 选项 | 类型 | 默认值 | 描述 |
|---|---|---|---|
--logLevel |
string | info |
日志详细程度：trace、debug、info、warn、error、silent |
--dataDir |
string | ~/.meticulous |
存储会话、重放和其他数据的目录 |
--jsonArgs |
string | — | 将所有选项作为 JSON 字符串传递（用于程序化/代理调用） |
--rawJson 是 --jsonArgs 的已弃用别名。--dryRun 不是全局选项——它仅适用于执行操作的命令（例如 ci / agent 运行触发和上传命令，以及 simulate）；请检查命令的参考或 meticulous schema <command>。
身份验证
命令通过 OAuth 进行身份验证。登录令牌存储在磁盘上并在会话之间重用——如果您未登录，交互式命令会自动打开浏览器登录（或运行 meticulous auth whoami 触发它）。请参阅 references/auth.md。
也支持 API 令牌（通过 --apiToken 或 METICULOUS_API_TOKEN 环境变量，限定到特定组织/项目），这是在非交互式上下文（如 CI）中进行身份验证的方式。
MCP 服务器
agent 命令也作为工具暴露在托管的 MCP 服务器 上，地址为 https://app.meticulous.ai/api/mcp，因此支持 MCP 的客户端（Claude Code、Cursor、Codex）可以直接调用它们，而不是通过 CLI 执行。大多数读取/分析命令映射到 get_<command> 工具，该工具返回与 CLI 命令的 --json 输出相同的数据——例如 agent test-run-diffs ⇄ get_test_run_diffs，agent dom-diff ⇄ get_dom_diff，以及 download session ⇄ get_session_data。两个可变命令（upload-build、trigger-test-run）也有 MCP 工具，但不是一一对应——请参阅 references/agent.md 获取完整映射，包括那个重要区别。只需使用端点 URL 连接（首次使用时浏览器 OAuth）。这些技能是用 CLI 术语编写的；如果您连接了 MCP 服务器，请在注明的地方替换为匹配的工具——但请注意，MCP 工具从不推断 git 上下文（commitSha/baseSha/diff），与 CLI 不同，因此在使用 MCP 时始终显式传递这些参数。
示例
# 打印所有命令的模式（代理使用）
meticulous schema
# 在本地运行单个重放
meticulous simulate --sessionId=<id> --appUrl=http://localhost:3000
