---
title: "mabl CLI command reference"
description: "This article provides a comprehensive overview of the commands available in the mabl CLI, including their usage, positional arguments, and options...."
last_updated: "2026-07-20"
source_url: "https://help.mabl.com/hc/en-us/articles/43605432188820-mabl-CLI-command-reference"
---

# mabl CLI command reference

> For the full index of agent-friendly pages, see [llms.txt](/llms.txt).

This article provides a comprehensive overview of the commands available in the mabl CLI, including their usage, positional arguments, and options.

mabl agent authoring answer

Answer the pending question on a paused cloud authoring session and resume it

``` terminal-block
mabl agent authoring answer {session-id} [text]

Positionals:
  session-id  The agent session ID to answer.  [string] [required]
  text        The answer text. Mutually exclusive with --file. One of text or --file is required.  [string]

Options:
  --version, -v           Show version number  [boolean]
  --help, -h              Show help  [boolean]
  --file                  Path to a file containing the answer text. Mutually exclusive with the text positional argument.  [string]
  --expected-loop-number  The loopNumber from "mabl agent authoring status --session-id {id}" for this session. Passing it rejects the answer if the session advanced since you read it (e.g. a dropped response on an earlier retry already committed a re-clarification), instead of silently rebinding this answer to whatever question is current. Omit for a one-shot answer with no retry protection.  [number]
```

mabl agent authoring initiate

Start test authoring from a planning session or direct test information

``` terminal-block
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.). Set test_id to edit an existing test instead of creating one (test_case carries the changes; name/URL not required). 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 drives the agent loop in this CLI process against a browser on your machine.  [choices: "cloud", "local"] [default: "cloud"]
  --headless             Run the local browser in headless mode (local mode only).  [boolean] [default: false]
  --verbose              Verbose agent-loop logging (local mode only).  [boolean] [default: false]
  --auto-save            Save the generated test on shutdown — on success, failure, or external terminate (local mode only). Matches the cloud agent default. Pass --no-auto-save to opt out.  [boolean] [default: true]
  --merge-source-branch  Merge the latest version of the test on this source branch (e.g. "master") into the branch being edited. Requires --test-information with both test_id and branch_id (an edit session on the target branch); the agent reconciles the two versions, preserving step identity for shared steps.  [string]
```

mabl agent authoring list

List cloud test-authoring sessions

``` terminal-block
mabl agent authoring list

Options:
  --version, -v   Show version number  [boolean]
  --help, -h      Show help  [boolean]
  --status        Filter by the session's latest instance status. Defaults to "needs_attention" (sessions waiting on user input). Pass "all" to list every status.  [string] [choices: "queued", "running", "needs_attention", "completed", "failed", "terminated", "terminating", "rate_limited", "skipped", "merged", "resuming", "none", "all"] [default: "needs_attention"]
  --limit         Maximum number of sessions to return per page.  [number]
  --workspace-id  Workspace ID to list sessions for.  [string]
  --api-key       mabl API key.  [string]
```

mabl agent authoring plan

Start or continue a test planning conversation with the mabl AI planning agent

``` terminal-block
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

Check the status of a test authoring session

``` terminal-block
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 authoring terminate

Stop an in-progress test authoring session. For local sessions, transitions the session to \`terminated\`; a running local CLI process detects the change on its next loop iteration, saves the in-progress test, and exits. For cloud sessions, behaves like the UI Terminate button.

``` terminal-block
mabl agent authoring terminate

Options:
  --version, -v  Show version number  [boolean]
  --help, -h     Show help  [boolean]
  --session-id   The agent session ID to terminate.  [string] [required]
  --reason       Termination reason. Only valid for cloud sessions; local sessions reject any non-default value.  [choices: "execution_timeout", "stop_requested", "infra_shutdown", "unknown"] [default: "stop_requested"]
```

mabl agent debug artifact

Get a forensic artifact (console, dom, network, screenshot) for a test run step

``` terminal-block
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

Print every subcommand under this group as a structured tree, including positionals and flags. Run \`\<subcommand\> --help\` for the formatted yargs help text.

``` terminal-block
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

Print every subcommand under this group as a structured tree, including positionals and flags. Run \`\<subcommand\> --help\` for the formatted yargs help text.

``` terminal-block
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

Print current variable context as JSON. Sources from state.json when available (the canonical-tree store the rest of the debug surface speaks); falls back to session.json for legacy sessions.

``` terminal-block
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

List the steps in the debug session with their execution status. Output is YAML by default; pass --output json for the machine-readable form. EvaluateFlow / StepGroup children are expanded inline. Each entry carries a 1-based dot-notation \`position\` (e.g. "3.2") that \`set-current-step\` accepts.

``` terminal-block
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

Run all remaining steps from current position to end, stopping on first failure

``` terminal-block
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

Execute a step in the debug session. Pass \<step-ref\> to run a specific step; omit it to run the step at the canonical-tree cursor (the same position list-steps shows as isCursor and set-current-step writes to). A \<step-ref\> can be the canonical step id, the 1-based flat position from list-steps (e.g. "14"), dot-notation through the step tree (e.g. "3.2"), or the synthetic "\<flow-id\>:\<idx\>" id list-steps falls back to when the underlying flow has no json_steps ids.

``` terminal-block
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

Run all steps from current position to the target step (inclusive), stopping on first failure. \<step-ref\> accepts the canonical step id, the 1-based flat position from list-steps (e.g. "14"), dot-notation (e.g. "3.2"), or the synthetic "\<flow-id\>:\<idx\>" fallback.

``` terminal-block
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

Move the execution cursor to a step (no execution — agent owns browser state). Accepts a step id or 1-based dot-notation position (e.g. "3.2").

``` terminal-block
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

Start a debug session for a test

``` terminal-block
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

Kill the debug Chrome process and delete the session directory

``` terminal-block
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

Get the failed and recovered (by Runtime recovery) steps from a test run. Pass --all for the full trace.

``` terminal-block
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

Install the mabl-debug skill (plus chrome-for-mabl and mabl MCP entries on supported targets) into an AI tool

``` terminal-block
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

Refresh tracked agent skills after upgrading the CLI

``` terminal-block
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

Create a new agent instruction

``` terminal-block
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

Delete an agent instruction

``` terminal-block
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

Describe an agent instruction

``` terminal-block
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

List agent instructions

``` terminal-block
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

Update an agent instruction

``` terminal-block
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

Describe a specific application

``` terminal-block
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

List your applications

``` terminal-block
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

Activate auth by api key

``` terminal-block
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

Clear logged in user

``` terminal-block
mabl auth clear

Options:
  --version, -v  Show version number  [boolean]
  --help, -h     Show help  [boolean]
```

mabl auth info

Display logged in user

``` terminal-block
mabl auth info

Options:
  --version, -v  Show version number  [boolean]
  --help, -h     Show help  [boolean]
```

mabl auth login

Authenticate the mabl CLI

``` terminal-block
mabl auth login

Options:
  --version, -v  Show version number  [boolean]
  --help, -h     Show help  [boolean]
  --auto         Capture the authorization code automatically. Useful in environments where the terminal input is not visible (e.g. agents, IDEs).  [boolean] [default: false]
```

mabl branches create

Create a new mabl branch

``` terminal-block
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

Delete a mabl branch by id or name

``` terminal-block
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

Describe a specific mabl branch by id or name

``` terminal-block
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

List mabl branches

``` terminal-block
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

Merge mabl branches

``` terminal-block
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

Delete a config value

``` terminal-block
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

Get a config value

``` terminal-block
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

Install add-on tools like mobile testing drivers

``` terminal-block
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

List all user config values

``` terminal-block
mabl config list

Options:
  --version, -v  Show version number  [boolean]
  --help, -h     Show help  [boolean]
```

mabl config set

Set a default configuration key

``` terminal-block
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

List your credentials

``` terminal-block
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

List your databases

``` terminal-block
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

Create a new mabl DataTable

``` terminal-block
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

Describe a specific DataTable

``` terminal-block
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

Export a DataTable in a specified file format

``` terminal-block
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

List your DataTables

``` terminal-block
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

List the scenarios of a datatable

``` terminal-block
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

Update a mabl DataTable

``` terminal-block
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

Trigger a deployment event via the mabl API

``` terminal-block
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

Describe a specific mabl deployment event

``` terminal-block
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

List recent mabl deployment events

``` terminal-block
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

Watch a mabl deployment event until completion, with results

``` terminal-block
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

Associate mobile build file with an environment

``` terminal-block
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

Show build files associated with an environment

``` terminal-block
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

Update mobile build file associated with an environment or add new association

``` terminal-block
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

Create a new mabl environment

``` terminal-block
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

Delete a mabl environment

``` terminal-block
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

Describe a specific environment

``` terminal-block
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

List your environments

``` terminal-block
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

Update a mabl environment. Note: This overwrites all existing environment variables set for the environment.

``` terminal-block
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

Associate URLs with an environment

``` terminal-block
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

Show URLs associated with an environment

``` terminal-block
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 compare

Compare the steps of two flows or flow versions

``` terminal-block
mabl flows compare {source} {target}

Positionals:
  source  The source (base) flow reference: "{id}" for the latest version, or "{id}:{version}"  [string] [required]
  target  The target flow reference to compare against the source: "{id}" or "{id}:{version}"  [string] [required]

Options:
  --version, -v              Show version number  [boolean]
  --help, -h                 Show help  [boolean]
  --show-all-properties, -a  Also print the full property set of every added, removed, and unchanged step. Changed steps always list the properties that differ (old → new), so by default only those are shown.  [boolean] [default: false]
  --output, -o               Output the raw structured diff as JSON instead of the formatted view  [choices: "json"]
```

mabl flows export

Export a mabl flow in a specified file format

``` terminal-block
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

List flows

``` terminal-block
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 flows search

Search flows by relevance using the text + semantic search agent

``` terminal-block
mabl flows search {query}

Positionals:
  query  Relevance query: natural language, keywords, or an exact name or id  [string] [required]

Options:
  --version, -v         Show version number  [boolean]
  --help, -h            Show help  [boolean]
  --context             Extra context for the search agent, e.g. a code-change overview (max 8000 chars)  [string]
  --application-id, -a  Scope the search to this application  [string]
  --labels              Space delimited labels; results must carry every label (exact match, max 20)  [array]
  --flow-type           Filter by flow type  [choices: "browser", "api", "mobile"]
  --platform            Filter mobile flows by platform  [choices: "ios", "android"]
  --updated-after       Only return flows updated after this ISO-8601 timestamp  [string]
  --limit, -l           The maximum number of flows to return (1-200)  [number] [default: 20]
  --output, -o          Specify result output format  [choices: "json", "yaml", "table"] [default: "json"]
  --workspace-id, -w    Workspace to search flows in  [string]
Examples:
  mabl flows search "reusable flow that fills out the checkout shipping form"                    Natural-language relevance search
  mabl flows search "login" --flow-type browser -o table                                         Keyword search, filtered, human-readable
  mabl flows search {flow-id}                                                                    Look up a single flow by its exact id
  mabl flows search 'api auth setup' -o json | jq -r '.[].id' | xargs -I{} mabl flows export {}  Pipe matched ids into another command
Smart search of browser, api, and mobile flows, combining full-text and semantic matching. Well-suited to discovery and CI gates, but takes time to do search. For full listings use 'flows list'. Matches are JSON on stdout by default (pass -o table for a human view); the id field composes with 'flows export'. No relevant matches will exit 0 with empty list; errors go to stderr with exit 1.
```

mabl link-agents delete

Delete link agents and infrastructure associate with the link agent label and block new agents with the given label for 15 minutes. Customers dynamically creating link agents must call this when the agent is no longer needed.

``` terminal-block
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

List link agents

``` terminal-block
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

Sends a shutdown signal to a specific Link Agent.

``` terminal-block
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

Delete a mobile build file.

``` terminal-block
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

Download a mobile build file.

``` terminal-block
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

List your mobile build files

``` terminal-block
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

Upload a new mobile build file

``` terminal-block
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

Describe a specific plan

``` terminal-block
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 edit-metadata

Edit a plan’s metadata (add or remove labels)

``` terminal-block
mabl plans edit-metadata {id}

Positionals:
  id  The id of the plan to edit  [string] [required]

Options:
  --version, -v    Show version number  [boolean]
  --help, -h       Show help  [boolean]
  --add-labels     Space delimited labels to add to the plan  [array]
  --remove-labels  Space delimited labels to remove from the plan  [array]
Examples:
  mabl plans edit-metadata {id} --add-labels smoke regression  add the "smoke" and "regression" labels to a plan
  mabl plans edit-metadata {id} --remove-labels flaky          remove the "flaky" label from a plan
```

mabl plans list

List plans

``` terminal-block
mabl plans list

Options:
  --version, -v       Show version number  [boolean]
  --help, -h          Show help  [boolean]
  --workspace-id, -w  Workspace to list plans for  [string]
  --labels            Space delimited plan labels to list plans for  [array]
  --output, -o        Specify result output format  [choices: "json", "yaml", "table"] [default: "table"]
  --limit, -l         The number of plans to fetch before label filtering  [string] [default: 10]
```

mabl test-runs export

Export browser test run artifacts. Defaults to screenshots only.

``` terminal-block
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 users list

List users from a workspace

``` terminal-block
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

copy data from one workspace to another

``` terminal-block
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

Describe a specific workspace

``` terminal-block
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

List your workspaces

``` terminal-block
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"]
```