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 |
讀取、分析並觸發測試執行——面向 agent 的指令，也在 MCP 伺服器上提供 |
auth |
向 Meticulous 進行身分驗證（登入、whoami、登出、專案選擇） |
debug |
設定適合 AI 偵錯的工作區，用於調查重播差異和重播 |
download |
在本機下載工作階段、重播和測試執行 |
local |
尋找與目前分支程式碼變更相關的工作階段 |
project |
檢查您已驗證的專案 |
simulate / replay |
針對某個 URL 重播已記錄的工作階段 |
schema |
以 JSON 格式輸出 CLI 指令結構（供 agent/程式化使用） |
每個群組的完整選項細節請參閱對應參考文件：
- 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 字串傳遞所有選項（適用於程式化/agent 呼叫） |
--rawJson 是 --jsonArgs 的已棄用別名。--dryRun 不是全域選項——它僅適用於執行操作的指令（例如 ci / agent 的觸發執行和上傳指令，以及 simulate）；請查閱指令的參考文件或 meticulous schema <command>。
身分驗證
指令透過 OAuth 進行身分驗證。登入 token 會儲存在磁碟上並跨工作階段重複使用——如果您尚未登入，互動式指令會自動開啟瀏覽器進行登入（或執行 meticulous auth whoami 來觸發）。請參閱 references/auth.md。
也支援 API token（透過 --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 工具，但並非 1:1 對應——請參閱 references/agent.md 以取得完整對應，包括這個重要差異。只需使用端點 URL 進行連線（首次使用時會進行瀏覽器 OAuth）。這些技能是以 CLI 為基礎撰寫的；如果您已連線 MCP 伺服器，請在提到的地方替換為對應的工具——但請注意，MCP 工具永遠不會推斷 git 上下文（commitSha/baseSha/diff），這與 CLI 不同，因此使用 MCP 時請務必明確傳遞這些參數。
範例
# 輸出所有指令的結構（供 agent 使用）
meticulous schema
# 在本機執行單次重播
meticulous simulate --sessionId=<id> --appUrl=http://localhost:3000
