qa start - Momentic

Arguments

[message]

string
The brief. Include the target URL, credentials or how to get them, and any boundaries Mo must respect. Required unless you select a PR with --pr.

Options

--pr

string
Test a named GitHub PR. Accepts a PR URL or owner/repo#123. Without a brief, Mo tests the changed app behavior and its regressions. Changes with no testable app behavior finish without launching testing agents.

--url

string
Choose the deployment for a PR session, including previews created by a coding agent or a custom deployment system. An environment needs no preview URL. Otherwise, without this option, Mo looks for one preview tied to the PR commit in Vercel, Cloudflare Pages, or Netlify posts. Discovery failures do not block startup; Mo can inspect the PR or ask you for the target. Ignored without --pr; include the target in the brief for a general session.

--patch

string
Send a reviewed Git patch when you cannot push local changes to the PR. Requires --pr. Run from the PR checkout: Mo uses local HEAD as the patch base and rejects it before starting if it differs from the published PR head. The deployment URL must serve those changes; sending a patch does not deploy them. Accepts text-only patches up to 256 KiB. Exclude secrets, logs, temporary files, generated outputs, blobs, and data files. Ignored without --pr.

--tunnel

string
Route Mo’s traffic through a tunnel started with qa tunnel start. Required when the target runs on your machine or a private network.

--max-concurrency

integer
Maximum number of sub-agents Mo runs at the same time. Must be a positive integer. The organization limit caps the value.

--time-budget

integer
Session time budget in whole minutes, from 10 to 480 (8 hours). Omit for no time limit. Counts active elapsed time, including time waiting for sub-agents. Waiting for your reply does not count. Set the budget at session start; you cannot change it later. Mo can finish reporting after the budget is spent.

--interaction-speed

string
Browser interaction speed: default (the default) or human. human adds 250 ms between steps in a batch and sets the default typing delay to 60 ms per keystroke. The first step and single-step calls have no added step delay. Explicit typing-step delays override the default.

--webgl

boolean
default:"false"
Enable experimental WebGL support for apps that render 3D graphics. Rendering uses the CPU, so graphics-heavy apps may run slowly. Applies to the session’s root browser and delegated browsers. Cannot be combined with --platform.

--environment

string
Start in a named workspace environment. Mo sees variable names, descriptions, and the literal BASE_URL starting URL. Values are available during execution.

--env-file

string
Load variables from a dotenv-format file into the session environment. Repeatable; a later file overrides earlier values for the same name. Requires Mo CLI 0.16.0.

--env-var

string
Copy one variable from your current shell environment into the session environment. Repeatable. The command fails if the variable is not set.

Output

The command prints one JSON object:

{ "sessionId": "<session-id>", "webUrl": "https://app.momentic.ai/..." }  

Keep sessionId for the other session commands. webUrl opens the session in the dashboard.

Examples

Give Mo a 60-minute budget for a bug bash:

qa start "Bug bash checkout on https://preview.example.com. Do not submit payment." --time-budget 60  

Test a PR using its preview deployment:

qa start --pr https://github.com/acme/shop/pull/42  
qa start "Check declined payments. Do not place an order." --pr acme/shop#42 --url https://preview.example.com  

Paste the full GitHub PR link, including a comment permalink if that is what you have. Query parameters and fragments are ignored; Mo keeps the repository and PR number. owner/repo#number also works.

Include only the files and hunks needed for testing. Include relevant untracked source files explicitly; git diff alone omits them. The CLI reads local HEAD as the base revision; a stale or different PR revision is rejected before Mo starts. Send the patch at startup so Mo has the source context before it begins.