この記事では、mabl CLIで使用できるコマンドについて、使い方、位置引数、オプションを含む包括的な概要を説明します。
mabl agent authoring initiate
プランニングセッションまたは直接のテスト情報からテストの作成を開始する
mabl agent authoring initiate
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--planning-session-id Planning session ID from "mabl agent authoring plan". Mutually exclusive with --test-information. [string]
--test-information JSON string with test information (name, test_case, deployment_id or url_override, etc.). Mutually exclusive with --planning-session-id. [string]
--plan Markdown test plan/outline. Only valid with --test-information. [string]
--test-type Type of test to create. [choices: "browser", "api"] [default: "browser"]
--api-spec API specification (OpenAPI/Swagger). Required when --test-type is api. [string]
--mode Execution mode. Cloud is recommended (parallelizable). Local is for testing locally running apps. [choices: "cloud", "local"] [default: "cloud"]
mabl agent authoring plan
mabl AIプランニングエージェントとのテストプランニング会話を開始または再開する
mabl agent authoring plan
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--intent Detailed description of what the test should do. Required for starting a new session. [string]
--session-id Planning session ID from a previous plan call. Required for follow-up changes. [string]
--changes Changes to request for an existing plan. Requires --session-id. [string]
mabl agent authoring status
テスト作成セッションのステータスを確認する
mabl agent authoring status
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--session-id The agent session ID from "mabl agent authoring initiate". [string] [required]
--verbose Show full details including latest agent message and test URL. Without this flag, only the status enum is returned for minimal output. [boolean] [default: false]
mabl agent debug artifact
テスト実行ステップのフォレンジックアーティファクト（コンソール、DOM、ネットワーク、スクリーンショット）を取得する
mabl agent debug artifact {type} {id}
Positionals:
type Artifact type to fetch [required] [choices: "console", "dom", "network", "screenshot"]
id Test run ID, e.g. abc123-jr [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--step-run-id Step run ID [string] [required]
--before Screenshot only — fetch the before-action snapshot rather than the post-action one [boolean] [default: false]
--print Stream the cached artifact contents to stdout (text artifacts only) [boolean] [default: false]
--head Stream the first N lines of the cached artifact to stdout. Note: console / network artifacts are typically a single JSON line, so --head N will return the whole blob; use --query for JSON, --bytes for a fixed-byte prefix. Mutually exclusive with --tail/--bytes/--print/--query/--text-only [number]
--tail Stream the last N lines of the cached artifact to stdout. Same caveat as --head: single-line JSON artifacts ignore line counts. Mutually exclusive with --head/--bytes/--print/--query/--text-only [number]
--bytes Stream the first N bytes of the cached artifact to stdout. Mutually exclusive with --head/--tail/--print/--query/--text-only [number]
--query Run a jq expression against the JSON artifact and stream the result to stdout. Only valid for console and network. Requires `jq` on PATH. [string]
--text-only DOM only — emit a one-line-per-element listing (role, name, id, data-testid) instead of the raw HTML [boolean] [default: false]
mabl agent debug command-list
このグループ配下のすべてのサブコマンドを、位置引数およびフラグを含む構造化ツリーとして表示します。フォーマットされたyargsヘルプテキストを確認するには、`{subcommand} --help` を実行してください。
mabl agent debug command-list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--output, -o Specify output format [choices: "json", "yaml"]
mabl agent debug session command-list
このグループ配下のすべてのサブコマンドを、位置引数およびフラグを含む構造化ツリーとして表示します。フォーマットされたyargsヘルプテキストを確認するには、`{subcommand} --help` を実行してください。
mabl agent debug session command-list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--output, -o Specify output format [choices: "json", "yaml"]
mabl agent debug session get-variables
現在の変数コンテキストをJSON形式で表示します。利用可能な場合は state.json（デバッグ機能全体が参照する正規ツリーのストア）を参照し、レガシーセッションの場合は session.json にフォールバックします。
mabl agent debug session get-variables {session-id}
Positionals:
session-id Debug session id (returned by `session start`). [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl agent debug session list-steps
デバッグセッションのステップを実行ステータスとともに一覧表示します。出力はデフォルトでYAML形式です。機械可読形式にするには --output json を指定してください。EvaluateFlow / StepGroup の子要素はインラインで展開されます。各エントリには、`set-current-step` が受け付ける1始まりのドット記法による `position`（例：「3.2」）が付与されます。
mabl agent debug session list-steps {session-id}
Positionals:
session-id Debug session ID [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--filter Case-insensitive substring match against the step description. Use to grep for "Application", "login", etc. without piping through grep. [string]
--around Show only the window of steps around the given step. Accepts a step id OR a 1-based position ("3", "4.1"). Use --context N to widen (default 5 before / 5 after). [string]
--from Show steps starting at the given step. Accepts a step id OR a 1-based position ("3", "4.1"). Combine with --limit to bound the window. [string]
--limit Cap the number of steps in the output. Combine with --from for a forward window. [number]
--context Window size for --around. Default 5 steps before and 5 after the target. [number] [default: 5]
--output, -o Output format (json | yaml). [choices: "json", "yaml"] [default: "yaml"]
mabl agent debug session run-all
現在の位置から最後まで残りのすべてのステップを実行し、最初の失敗で停止する
mabl agent debug session run-all {session-id}
Positionals:
session-id Debug session id (returned by `session start`). [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl agent debug session run-step
デバッグセッションでステップを実行します。特定のステップを実行するには {step-ref} を指定してください。省略した場合は、正規ツリーカーソル位置（list-steps で isCursor として表示され、set-current-step が書き込む位置）のステップが実行されます。{step-ref} には、正規のステップID、list-steps による1始まりのフラット位置（例：「14」）、ステップツリーのドット記法（例：「3.2」）、または基となるフローに json_steps IDがない場合に list-steps が代替として使用する「{flow-id}:{idx}」形式のIDを指定できます。
mabl agent debug session run-step {session-id} [step-id]
Positionals:
session-id Debug session id (returned by `session start`). [string] [required]
step-id Step reference: canonical step id, 1-based flat position (e.g. "14"), dot-notation (e.g. "3.2"), or synthetic "{flow-id}:{idx}". Omit to run the step at the cursor. [string]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl agent debug session run-to-step
現在の位置から対象のステップまで（対象を含む）すべてのステップを実行し、最初の失敗で停止します。{step-ref} には、正規のステップID、list-steps による1始まりのフラット位置（例：「14」）、ドット記法（例：「3.2」）、または代替形式の「{flow-id}:{idx}」を指定できます。
mabl agent debug session run-to-step {session-id} {step-id}
Positionals:
session-id Debug session id (returned by `session start`). [string] [required]
step-id Target step reference: canonical step id, 1-based flat position (e.g. "14"), dot-notation (e.g. "3.2"), or synthetic "{flow-id}:{idx}". [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl agent debug session set-current-step
実行カーソルをステップに移動します（実行なし — ブラウザの状態はエージェントが管理）。ステップIDまたは1始まりのドット記法による位置（例：「3.2」）を指定できます。
mabl agent debug session set-current-step {session-id} {step-id}
Positionals:
session-id Debug session id (returned by `session start`). [string] [required]
step-id Step id (UUID) OR 1-based dot-notation position (e.g. "3.2"). Nested addressing ("3.2") requires step 3 to be a step-group / reusable-flow wrapper; for a leaf, use the bare position ("3"). Run `list-steps` to discover both shapes. [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl agent debug session start
テストのデバッグセッションを開始する
mabl agent debug session start [test-id]
Positionals:
test-id The ID of the test to debug, e.g. abc123-j. Optional when --run-id is given (the test id and most flags are then derived from the run). [string]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--environment-id, -e Mabl environment ID to load environment variables from. Setting the environment does not override the default URL — use --url for that. [string]
--url, -u URL to run the test against [string]
--credentials-id, --creds Credentials ID to run the test with [string]
--basic-auth-credentials-id, --basic-creds Basic Authentication credentials ID for adding basic auth headers to the test run [string]
--browser Target browser for the test run. One of chrome, edge, firefox, webkit. Defaults to chrome. [string] [choices: "chrome", "edge", "firefox", "webkit"]
--width Browser viewport width in pixels [number] [default: 1080]
--height Browser viewport height in pixels [number] [default: 1440]
--locale Locale to emulate, e.g. en-US [string]
--timezone-id Timezone identifier to emulate, e.g. America/New_York [string]
--user-agent Emulate a custom User-Agent string (e.g. "Mozilla/5.0 …") [string]
--interaction-speed Speed at which mabl interacts with web pages. Overrides test run settings if specified. [string] [choices: "fast", "normal", "slow", "slower"]
--mabl-branch Mabl branch to load test and flows from [string]
--headless Run the browser in headless mode [boolean] [default: false]
--run-id A test run ID (e.g. abc123-jr) to derive flags from. Sets test-id, url, browser, credentials, environment, locale and timezone from the run; explicit flags override. [string]
--port Remote debugging port for Chrome. Defaults to 9222 so it lines up with the chrome-for-mabl MCP server entry. Pass 0 to let Chrome pick a free port. [number] [default: 9222]
mabl agent debug session stop
デバッグ用のChromeプロセスを終了し、セッションディレクトリを削除する
mabl agent debug session stop {session-id}
Positionals:
session-id Debug session id (returned by `session start`). [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl agent debug steps
テスト実行から失敗したステップおよび（実行時リカバリによって）リカバリされたステップを取得する。完全なトレースを取得するには --all を渡してください。
mabl agent debug steps {id}
Positionals:
id Test run ID, e.g. abc123-jr [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--all Emit every executed step instead of the failed/recovered subset. The summary block is unchanged. [boolean] [default: false]
--output, -o Output format (json | yaml). [choices: "json", "yaml"] [default: "yaml"]
mabl agent install
mabl-debugスキル（および対応ターゲットへのchrome-for-mablとmabl MCPエントリ）をAIツールにインストールする
mabl agent install {target}
Positionals:
target AI tool to install into (supported: agents-md, claude, copilot, cursor, vscode) [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--scope Install scope: 'user' (in your home directory) or 'project' (in the current directory). 'agents-md' is project-only. [string] [choices: "project", "user"] [default: "user"]
--force Overwrite an existing skill file and replace any existing chrome-for-mabl / mabl MCP entries [boolean] [default: false]
--skip-mcp Install the skill only; do not touch the target MCP configuration [boolean] [default: false]
--append-snippet Also append the mabl agent debug snippet to the agent instruction file (CLAUDE.md, .cursorrules, AGENTS.md, …) [boolean] [default: false]
mabl agent update
CLIのアップグレード後に追跡済みエージェントスキルを更新する
mabl agent update
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--target Only update installations for this target (agents-md, claude, copilot, cursor, vscode) [string] [choices: "agents-md", "claude", "copilot", "cursor", "vscode"]
--scope Only update installations at this scope (project or user) [string] [choices: "project", "user"]
--yes, -y Update every matching stale installation without prompting [boolean] [default: false]
--quiet Suppress informational output; only print prune notices, errors, and the final summary when an update actually happened [boolean] [default: false]
mabl agent-instructions create
新しいエージェント指示を作成する
mabl agent-instructions create
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to create instruction in [string]
--name, -n Name for the instruction [string] [required]
--instruction-text The instruction text (max 1000 characters) [string] [required]
--capabilities Capabilities to scope to (authoring, recovery, results_analysis) [array]
--application-ids Application IDs to scope the instruction to [array]
--environment-ids Environment IDs to scope the instruction to [array]
--disabled Create the instruction in a disabled state [boolean] [default: false]
mabl agent-instructions delete
エージェント指示を削除する
mabl agent-instructions delete {id}
Positionals:
id The instruction ID [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl agent-instructions describe
エージェント指示の詳細を表示する
mabl agent-instructions describe {id}
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--output, -o Specify output format [choices: "json", "yaml"]
mabl agent-instructions list
エージェント指示を一覧表示する
mabl agent-instructions list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to list agent instructions for [string]
--limit, -l The number of agent instructions to return' [string] [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
mabl agent-instructions update
エージェント指示を更新する
mabl agent-instructions update {id}
Positionals:
id The instruction ID [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--name Updated name [string]
--instruction-text Updated instruction text [string]
--capabilities Updated capabilities (authoring, recovery, results_analysis) [array]
--application-ids Updated application IDs [array]
--environment-ids Updated environment IDs [array]
--disabled Disable the instruction [boolean]
--enabled Enable the instruction [boolean]
mabl applications describe
特定のアプリケーションを説明する
mabl applications describe {id}
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--output, -o Specify output format [choices: "json", "yaml"]
mabl applications list
アプリケーションを一覧表示する
mabl applications list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to list applications for [string]
--limit, -l The number of applications to return' [string] [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
mabl auth activate-key
APIキーによる認証を有効化する
mabl auth activate-key {api-key}
Positionals:
api-key API key (escape leading dashes with "\" (e.g. "\-yourKey") [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl auth clear
ログイン済みユーザーをクリア
mabl auth clear
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl auth info
ログイン中のユーザーを表示
mabl auth info
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl auth login
mabl CLI を認証する
mabl auth login
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl branches create
新しい mabl ブランチを作成する
mabl branches create {name}
Positionals:
name Name of the mabl branch to create [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--output, -o Specify an output type for the branch data [choices: "json", "yaml"]
--workspace-id, -w The workspace ID to create a new branch [string]
mabl branches delete
IDまたは名前でmablブランチを削除する
mabl branches delete {identifier}
Positionals:
identifier The branch ID or NAME to delete [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--name, -n Use identifier as branch name [boolean] [default: false]
--workspace-id, -w The workspace ID to delete a branch by name [string]
mabl branches describe
IDまたは名前で特定のmablブランチを説明する
mabl branches describe {identifier}
Positionals:
identifier The branch ID or NAME to describe [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--name, -n Use identifier as Get branch based on name [boolean] [default: false]
--output, -o Specify an output type for the branch data [choices: "json", "yaml"]
--workspace-id, -w The workspace ID to create a new branch [string]
mabl branches list
mabl ブランチの一覧表示
mabl branches list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--limit, -l Item return limit [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
--status, -s filter results by status [choices: "open", "merged"]
--workspace-id, -w The workspace ID to list branches for
mabl branches merge
mablブランチをマージする
mabl branches merge
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--from, -f Name of the mabl branch to merge from [string] [required]
--to, -t Name of the mabl branch to merge to [string] [default: "master"]
--output, -o Specify an output type for the branch data [choices: "json", "yaml"]
--workspace-id, -w The workspace ID to create a new branch [string]
mabl config delete
設定値を削除する
mabl config delete {config-key}
Positionals:
config-key configuration key to delete [string] [required] [choices: "browser.path", "alpha.scm_metadata.enable", "workspace", "http.proxy", "http.sslVerify", "http.proxyMode", "http.proxyType"]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl config get
設定値を取得する
mabl config get {config-key}
Positionals:
config-key desired configuration key [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl config install
モバイルテストドライバーなどのアドオンツールをインストールする
mabl config install {add-on}
Positionals:
add-on add-on to install [string] [required] [choices: "mobile-tools", "browser"]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--android [mobile-tools] The android driver version to use [string]
--ios [mobile-tools] The ios driver version to use [string]
--chrome [browser] The chrome browser version to use [boolean]
mabl config list
すべてのユーザー設定値を一覧表示する
mabl config list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl config set
デフォルトの設定キーを設定する
mabl config set {config-key} {config-value}
Positionals:
config-key The configuration key to set [string] [required] [choices: "browser.path", "alpha.scm_metadata.enable", "workspace", "http.proxy", "http.sslVerify", "http.proxyMode", "http.proxyType"]
config-value The value to configure for the config [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl credentials list
クレデンシャルを一覧表示する
mabl credentials list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to list credentials for [string]
--limit, -l The number of credentials to return' [string] [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
mabl databases list
データベースを一覧表示する
mabl databases list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to list databases for [string]
--limit, -l The number of databases to return' [string] [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
mabl datatables create
新しい mabl データテーブルを作成する
mabl datatables create {input}
Positionals:
input, file Relative path file to create DataTable from [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to create DataTable in [string]
--name, --table-name The name for your new DataTable [string]
--format, --fmt Specify the format of your input file (checks file extension type by default) [choices: "json", "csv"]
mabl datatables describe
特定のデータテーブルを説明する
mabl datatables describe {id}
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--output, -o Specify output format [choices: "json", "yaml"]
mabl datatables export
指定したファイル形式でデータテーブルをエクスポートする
mabl datatables export {id}
Positionals:
id DataTable id to export [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--format, --fmt Specify a format for the DataTable export [choices: "json", "yaml", "csv"] [default: "json"]
mabl datatables list
データテーブルの一覧表示
mabl datatables list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to list datatables for [string]
--limit, -l The number of datatables to return' [string] [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
mabl datatables scenarios
データテーブルのシナリオを一覧表示する
mabl datatables scenarios {id}
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--limit, -l The number of scenarios to return' [string] [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
mabl datatables update
mabl データテーブルを更新する
mabl datatables update {id} {input}
Positionals:
id ID of DataTable to update [string] [required]
input, file Relative path file to create DataTable from [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace your DataTable is exists in [string]
--format, --fmt Specify the format of your input file (checks file extension type by default) [choices: "json", "csv"]
mabl deployments create
mabl APIを通じてデプロイメントエベントをトリガーする
mabl deployments create
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--application-id, -a Application to run the mabl tests for. If provided, mabl will only trigger plans that contain this application [string]
--environment-id, -e Environment to run the mabl tests for. If provided, mabl will only trigger plans that contain this environment [string]
--override-environment-id Override environment to run the tests against. Not used to select plans to run. Requires `--application-id`. [string]
--await-completion Block until mabl tests complete. [boolean] [default: false]
--fast-failure If using '--await-completion', exit on first failed test [boolean] [default: false]
--silent Don't output runtime status [boolean] [default: false]
--output, -o Specify final result output format. Implies: --silent [choices: "json", "yaml"]
--workspace-id, -w Workspace containing target environment and/or application [string]
--browsers, -b Space delimited browsers to test against (e.g. "chrome firefox") [array] [choices: "chrome", "edge", "firefox", "webkit"] [default: []]
--labels, -l Space delimited plan labels. Run plans that match any label. [array] [default: []]
--http-headers Space delimited HTTP headers added to browser requests (e.g. "x-header:foo") [array] [default: []]
--url, -u URL to use for deployment [string]
--app-url Application/web URL to use for deployment [string]
--api-url API URL to to use for deployment [string]
--android-app-file-id Android mobile app file to use for deployment [string]
--ios-app-file-id iOS mobile app file to use for deployment [string]
--api-key, -k API key (found in the mabl web app) [string]
--rebaseline-images, --rbi Rebaseline visual change models [boolean] [default: false]
--set-static-baseline, --ssbi Set run as fixed baseline for visual change models [boolean] [default: false]
--revision, --rev Code revision hash (application under test) [string]
--repository-url Code repository URL (e.g. git@github.com:foo/bar.git) [string]
--mabl-branch mabl branch to run tests against [string]
--auto-branch Create a mabl branch when a mabl-branch target is specified that does not exist [boolean] [default: false]
--snapshot-from Snapshot the current state of the tests from a mabl branch onto the environment. Use "master" for the mainline branch. Requires setting environment-id. [string]
mabl deployments describe
特定のmablデプロイメントエベントを説明する
mabl deployments describe {id}
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--output, -o Specify and alternate output for the deployment data [choices: "json", "yaml", "markdown"]
mabl deployments list
最近の mabl デプロイメントエベントを一覧表示する
mabl deployments list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to list deployments for [string]
--limit, -l The number of deployments to return' [string] [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
mabl deployments watch
結果とともに、mabl のデプロイメントエベントが完了するまで監視する
mabl deployments watch {id}
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--fast-failure Exit on first failed test [boolean] [default: false]
--silent Don't output runtime status [boolean] [default: false]
--output, -o Specify final result output format. Implies: --silent [choices: "json", "yaml"]
mabl environments build-files add
モバイルビルドファイルを環境に関連付ける
mabl environments build-files add {id}
Positionals:
id ID of environment to add mobile build file associations to [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--application-id ID of application to associate with this environment [string] [required]
--build-file-id mobile build file ID to associate with the application-environment pair [string] [required]
mabl environments build-files list
環境に関連するビルドファイルを表示する
mabl environments build-files list {id}
Positionals:
id Environment ID to list build file associations for [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--application-id, -a Application ID to filter build files by [string]
--limit, -l The number of build files to return' [string] [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
mabl environments build-files update
環境に関連付けられたモバイルビルドファイルを更新するか、新しい関連付けを追加する
mabl environments build-files update {id}
Positionals:
id ID of environment to update mobile build file association [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--application-id ID of application to associate with this environment [string] [required]
--build-file-id mobile build file ID to associate with the application-environment pair [string] [required]
mabl environments create
新しい mabl 環境を作成する
mabl environments create
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--application-id Id of application to associate with this environment [string]
--app-url Web application URLs to associate with the application-environment pair [array]
--api-url API URLs to associate with the application-environment pair [array]
--name, -n Name of the environment [string] [required]
--description Description of the environment [string]
--variables Key-value environment variable pairs of the form var1:value1 [array] [default: []]
--link Name of link agent to use for this environment [string]
--mabl-branch Name of mabl branch to associated with this environment. Tests run against this environment will use the version on this branch. [string]
--preview Set to true to mark this as an preview environment [boolean] [default: false]
--workspace-id, -w Workspace containing to create environment in [string]
mabl environments delete
mabl 環境の削除
mabl environments delete {id}
Positionals:
id Environment id to delete [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl environments describe
特定の環境を説明する
mabl environments describe {id}
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--decrypt Set to decrypt and return environment variables as part of the payload [boolean]
--output, -o Specify output format [choices: "json", "yaml"]
mabl environments list
環境を一覧表示する
mabl environments list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to list environments for [string]
--limit, -l The number of environments to return' [string] [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
mabl environments update
mabl 環境を更新します。注意：この操作を行うと、その環境に設定されている既存の環境変数がすべて上書きされます。
mabl environments update {id}
Positionals:
id ID of environment to update [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--name, -n Name of the environment [string]
--description Description of the environment [string]
--variables Key-value environment variable pairs of the form var1:value1 [array] [default: []]
--link Name of link agent to use for this environment [string]
--mabl-branch Name of mabl branch to associated with this environment. Tests run against this environment will use the version on this branch. [string]
--preview Set to true to mark this as an preview environment [boolean] [default: false]
mabl environments urls add
URLを環境に関連付ける
mabl environments urls add {id}
Positionals:
id Id of environment to add URL associations to [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--application-id id of application to associate with this environment [string] [required]
--app-url web application URLs to associate with the application-environment pair [array]
--api-url API URLs to associate with the application-environment pair [array]
mabl environments urls list
環境に関連付けられたURLを表示する
mabl environments urls list {id}
Positionals:
id Environment id to list URL associations for [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--application-id, -a Application id to filter URLs by [string]
--limit, -l The number of URLs to return' [string] [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
mabl flows export
指定したファイル形式でmablフローをエクスポートする
mabl flows export {id}
Positionals:
id flow id to export [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--format, --fmt Specify a format for the flow export [choices: "json", "yaml", "csv", "postman"] [default: "yaml"]
--mabl-branch Which branch of the flow to export [string]
mabl flows list
フローの一覧表示
mabl flows list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to list flows for [string]
--limit, -l The number of flows to return [string] [default: 10]
mabl link-agents delete
リンクエージェントのラベルに関連付けられたリンクエージェントとインフラストラクチャを削除し、指定されたラベルを持つ新しいエージェントを15分間ブロックします。リンクエージェントを動的に作成するお客様は、エージェントが不要になった際にこの操作を呼び出す必要があります。
mabl link-agents delete {link}
Positionals:
link label of the link agent [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id workspace id of the link agent [string]
mabl link-agents list
リンクエージェントの一覧表示
mabl link-agents list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace for which to list link agents [string]
--output, -o Specify result output format [choices: "json", "yaml", "table"] [default: "table"]
--limit, -l The number of link agents to return [number] [default: 10]
--max-heartbeat-age Only returns link agents that have sent a heartbeat within this number of seconds [number] [default: 300]
mabl link-agents terminate
特定のリンクエージェントにシャットダウン信号を送信します。
mabl link-agents terminate {id}
Positionals:
id id of the link agent to terminate [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl mobile-build-files delete
モバイルビルドファイルを削除します。
mabl mobile-build-files delete {id}
Positionals:
id ID of the mobile build file [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl mobile-build-files download
モバイルビルドファイルをダウンロードします。
mabl mobile-build-files download {id} {destination}
Positionals:
id ID of the mobile build file [string] [required]
destination Relative path to destination directory or file [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
mabl mobile-build-files list
モバイルビルドファイルの一覧表示
mabl mobile-build-files list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to list mobile build files for [string]
--limit, -l The number of mobile build files to return' [string] [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
--platform Filter results to a single mobile platform [string] [choices: "android", "ios"]
mabl mobile-build-files upload
新しいモバイルビルドファイルをアップロードする
mabl mobile-build-files upload {build-file-path}
Positionals:
build-file-path Relative path to mobile build file file [required]
Options:
--help, -h Show help [boolean]
--branch Branch from which this mobile build file was built [string]
--labels Space delimited labels to save the file with [array]
--platform The mobile platform [string] [choices: "android", "ios"] [default: inferred from app binary extension]
--version Version of this mobile build file [string]
--workspace-id, -w Workspace to create mobile build file in [string]
mabl plans describe
特定のプランを説明する
mabl plans describe {id}
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--output, -o Specify output format [choices: "json", "yaml"]
mabl plans list
プランの一覧表示
mabl plans list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to list plans for [string]
--output, -o Specify result output format [choices: "json", "yaml", "table"] [default: "table"]
--limit, -l The number of plans to return [string] [default: 10]
mabl test-runs export
ブラウザのテスト実行アーティファクトをエクスポートします。デフォルトではスクリーンショットのみが対象です。
mabl test-runs export {id} [options]
Positionals:
id test run id [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--file export to specific file, default: local path/export name [string]
--types types to export, defaults to screenshots only [array] [choices: "all", "screenshots", "console_logs", "doms", "hars", "traces", "xray_json", "variables"] [default: ["screenshots"]]
Examples:
mabl test-runs export {id} export test run screenshots to file
mabl test-runs export {id} --types screenshots doms export test run screenshots and doms to file
mabl test-runs export {id} --types all export test run all types to file
mabl tests cloud-status
create --mode cloud によって開始されたクラウドテスト生成のステータスを確認します
mabl tests cloud-status
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--session-id The agent session ID from create --mode cloud [string] [required]
--instance-id The cloud instance ID from create --mode cloud [string]
--output Output format: "json" for machine-readable output [string]
mabl tests create
mablトレーナーを使用してブラウザテストを作成します
mabl tests create {url} {test-name}
Positionals:
url The url to test [string] [required]
test-name The name of the test [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--desc, --test-description Description for the test [string] [default: ""]
--width Set the browser width in pixels [number] [default: 1080]
--height Set the browser height in pixels [number] [default: 1440]
--mabl-branch Branch to run the mabl test against [string]
--environment-id, -e Mabl environment to create test under [string]
--application-id, -a Mabl application to create test under [string]
--plan-id Mabl plan to use the config from and add the test to upon completion [string]
--auto-branch Create a mabl branch when a mabl-branch target is specified that does not exist [boolean] [default: false]
--auto-login Insert an auto login flow at the beginning of the created test [boolean] [default: false]
--labels Space delimited labels to save test with [array]
--data-tables Space delimited data table IDs to use with test [array]
--workspace-id, -w Workspace to create test in [string]
--credentials-id, --creds Credentials ID to run the test with [string]
--intent Intent for the test, e.g. "smoke", "regression" [string]
--disabled Create the test in a disabled state [boolean] [default: false]
--empty Create a minimal test with only viewport and visit-URL steps [boolean] [default: false]
--mode Test generation mode: "local" runs locally (default), "cloud" runs in the mabl cloud and returns session/instance IDs for polling status. [string] [choices: "local", "cloud"] [default: "local"]
mabl tests edit
ブラウザテストを編集します
mabl tests edit
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--id the id of the test to edit [string]
--run-id The id of the test run to pull config from [string]
--mabl-branch Branch to edit the mabl test against [string]
--auto-branch Create a mabl branch when a mabl-branch target is specified that does not exist [boolean] [default: false]
--environment-id, -e Mabl environment to edit the test under. Specify to edit the test with environment variables and the latest find information. [string]
--application-id, -a Mabl application to edit the test under [string]
--width Set the browser width in pixels [number] [default: 1080]
--height Set the browser height in pixels [number] [default: 1440]
--url, -u URL to edit the mabl test against [string]
--credentials-id, --creds Credentials ID to edit the test with [string]
Examples:
mabl tests edit --id {id} edit test in the Trainer by id
mabl tests edit --run-id {test-run-id} edit a browser test in the Trainer in the context of a test configuration from a cloud run
mabl tests export
指定したファイル形式でmablブラウザテストをエクスポートします
mabl tests export {id}
Positionals:
id test id to export [string] [required]
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--format, --fmt Specify a format for the test export [choices: "json", "yaml", "csv", "playwright", "postman", "side"] [default: "yaml"]
--mabl-branch Which branch of the test to export [string]
--environment-id, -e Generate selectors based on the find information learned in this environment (Playwright only) [string]
--file Export to specific file, default: local path/export name [string]
mabl tests import playwright
[LABS]: 既存のPlaywrightテストをインポートします。
mabl tests import playwright
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--auto-save Automatically save imported test when complete [boolean] [default: false]
--workspace-id, -w Workspace into which tests should be imported [string]
--path Project location. Current directory is default [string]
--project Name of the Playwright project to run. You will find the list of your playwright projects in the playwright.config.ts file under the projects array. This project must have tracing enabled. [string]
--grep Grep argument to pass to Playwright to filter tests [string]
--extra-arguments Extra arguments to pass to playwright [string]
--tests-path Path where the tests are located [string] [default: "tests"]
--trace-file Path of a single playwright trace file to import [string]
--traces-path Path of the directory containing playwright trace files to import [string]
mabl tests import selenium
既存のSeleniumベースのテストをインポートします
mabl tests import selenium
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--auto-save Submit the captured session to the cloud authoring agent without prompting [boolean] [default: false]
--multi Capture multiple tests at once [boolean] [default: false]
--name, -n The name to give this test in mabl [string]
--port The port on which the Selenium proxy should listen [number] [default: 8889]
--workspace-id, -w Workspace into which tests should be imported [string]
--credentialsId Workspace credential ID to bind to the imported test. Pass when the captured login uses secrets from an external vault that do not match any mabl credential. [string]
--useLink Bias the planner toward applications and environments configured for the Link Agent [boolean] [default: false]
--no-plan Skip the planning agent and submit the captured session directly to the test authoring agent [boolean] [default: false]
mabl tests list
テストを一覧表示します
mabl tests list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to list tests for [string]
--labels Space delimited test labels to list tests for [array]
--output, -o Specify result output format [choices: "json", "yaml", "table"] [default: "table"]
--limit, -l The number of tests to return [string] [default: 10]
mabl tests run
ヘッドレスをサポートしながらテストをローカルで実行します
mabl tests run
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--id The id of the test to run [string]
--run-id The id of the test run to pull config from [string]
--from-plan-id The plan id to get a list of tests from.
Note: running tests with the --from-plan-id option is not a plan run. Advanced plan configurations, such as stages, browser settings or shared variables, are not applied. [string]
--mabl-branch Mabl branch to run test against [string]
--branch-changes-only Only execute tests changed on specified mabl branch [boolean] [default: false]
--labels Space delimited test labels. Run tests that match any label. [array]
--exclude-labels Space delimited test labels. Exclude tests that match any label. [array]
--workspace-id, -w Workspace to run against [string]
--application-id, -a Mabl application used to report test results. [string]
--environment-id, -e Mabl environment to run under. Specify to ensure the test runs with environment variables and the latest find information.
Note: Setting the environment does not override the default URL. Please use the (—url) command to override the URL. [string]
--locale Locale to run the test in, e.g. en-US [string]
--timezone-id Identifier of the timezone to run the test in, e.g. America/Buenos_Aires [string]
--width Set the browser width in pixels [number] [default: 1080]
--height Set the browser height in pixels [number] [default: 1440]
--url, -u URL to run the mabl test against [string]
--credentials-id, --creds Credentials ID to run the test with [string]
--data-table-id Run test using all the scenarios from the Data table ID [string]
--scenario-id Run test using an specific scenario [string]
--basic-auth-credentials-id, --basic-creds Basic Authentication credentials for adding basic auth headers to test run [string]
--headless Should the test run headless or not [boolean] [default: false]
--highlights Highlight elements before interacting with them. Highlighting introduces a small delay for each step. [boolean] [default: false]
--keep-browser-open Prevent the browser from closing at the end of a test. [boolean] [default: false]
--reporter Output test run information with specified reporter. [string] [choices: "mochawesome", "mabl"]
--enable-browser-extensions Enable browser extensions on [Chrome] and [Edge] [boolean] [default: false]
--http-headers Space delimited HTTP headers added to browser requests (e.g. "x-header:foo") [array]
--user-agent Emulates a custom user-agent (e.g. "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4651.0 Safari/537.36") [string]
--interaction-speed Set the speed that mabl interacts with webpages. Overrides test run settings if specified. [string] [choices: "fast", "normal", "slow", "slower"]
--allow-billable-features Allow execution of billable features like AI assertions in CLI runs [boolean] [default: false]
--artifacts-dir Directory to write observation artifacts (screenshots). Defaults to a temp directory. [string]
Examples:
mabl tests run --id {id} --headless run test locally by id in headless mode
mabl tests run --run-id {test-run-id} run a test locally using the test configuration from a cloud run
mabl tests run-cloud
mablクラウドでテストを実行します
mabl tests run-cloud
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--id The id of the test to run [string]
--deployment-id, -d Deployment to run the mabl tests against [string]
--url, -u Alias for app-url [string]
--app-url Application/web URL to run the mabl test against [string]
--api-url API URL to run the mabl test against [string]
--basic-auth-credentials-id, --basic-creds Basic Authentication credentials to run the test with [string]
--browsers, -b Space delimited browsers to test against (e.g. "chrome edge firefox") [array] [required] [choices: "chrome", "edge", "firefox", "webkit"] [default: "chrome"]
--api-key, -k API key (found in the mabl web app) [string]
--mabl-branch Mabl branch to run test against [string]
--branch-changes-only Only execute tests changed on specified branch [boolean] [default: false]
--revision, --rev Code revision hash (application under test) [string]
--labels Space delimited test labels. Run tests that match any label. [array]
--exclude-labels Space delimited test labels. Exclude tests that match any label. [array]
--workspace-id, -w Workspace to run against [string]
--application-id, -a Mabl application to run under. Specify to ensure the test runs with the right URLs. Consider also using the environment-id flag. [string]
--environment-id, -e Mabl environment to run under. Specify to ensure the test runs with environment variables and the latest find information. Consider also using the application-id flag. [string]
--credentials-id, --creds Credentials ID to run the test with [string]
--locale Locale to run the test in, e.g. en-US [string]
--timezone-id Identifier of the timezone to run the test in, e.g. America/Buenos_Aires [string]
--prompt Prompt to confirm execution selections [boolean] [default: true]
--no-prompt, --yes Do not prompt to confirm execution selections
Examples:
mabl tests run-cloud --id {id} run test by id
mabl tests run-cloud --labels {label1} {label2} run tests by test label
mabl tests run-mobile
モバイルテストをローカルで実行します
mabl tests run-mobile
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--id The id of the test to run [string]
--build-file-path, --app-file The path to the mobile application binary [string]
--build-file-id The ID of a previously uploaded mobile app file [string]
--platform The mobile platform [string] [choices: "android", "ios"] [default: inferred from app binary extension]
--workspace-id, -w Workspace to run against [string]
--credentials-id, --creds Credentials ID to run the test with [string]
--environment-id, -e Mabl environment to run under. Specify to ensure the test runs with environment variables. [string]
--from-plan-id The plan id to get a list of tests from.
Note: running tests with the --from-plan-id option is not a plan run. Advanced plan configurations, such as stages, browser settings or shared variables, are not applied. [string]
--run-id The id of the test run to pull config from [string]
--device Full name of the device to use for the test [string]
--mabl-branch Mabl branch to run test against [string]
--branch-changes-only Only execute tests changed on specified mabl branch [boolean] [default: false]
--labels Space delimited test labels. Run tests that match any label. [array]
--exclude-labels Space delimited test labels. Exclude tests that match any label. [array]
--allow-billable-features Allow execution of billable features like AI assertions in CLI runs [boolean] [default: false]
Examples:
mabl tests run-mobile --id {id} --app-file {path} --platform {platform} run mobile test locally by id
mabl users list
ワークスペースのユーザーを一覧表示する
mabl users list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--workspace-id, -w Workspace to list users for [string]
--limit, -l The number of users to return' [string] [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]
mabl workspaces copy
あるワークスペースから別のワークスペースにデータをコピーする
mabl workspaces copy
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--from The workspace from which to copy [required]
--to The workspace the data will be copied into [required]
--include-defaults Include default tests when copying [boolean] [default: false]
--included-tests List of test ids to include with the copy. If empty, all tests will be copied. [array] [default: []]
--excluded-tests List of test ids to exclude from the copy. If a test is in both the include and exclude list, it will be excluded. [array] [default: []]
mabl workspaces describe
特定のワークスペースを説明する
mabl workspaces describe {id}
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--output, -o Specify output format [choices: "json", "yaml"]
mabl workspaces list
ワークスペースを一覧表示します
mabl workspaces list
Options:
--version, -v Show version number [boolean]
--help, -h Show help [boolean]
--limit, -l The number of workspaces to return [default: 10]
--output, -o Specify result output format [choices: "json", "yaml"]