qa read to follow its output.
start when the message is a bare URL:
Arguments
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
Send Mo reports and requests for input to a Slack channel ID or name, with or
without
#. Connect the Momentic Slack app to your workspace and invite it to
the channel first. An invalid destination rejects the start before a session
is created. Works for general and PR sessions.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.Choose the deployment for a PR session, including previews created by a coding
agent or a custom deployment system. Without this option, Mo looks once for a
preview tied to the PR commit in Vercel, Cloudflare Pages, or Netlify posts,
and the start fails if it finds none, even with
--environment. Ignored
without --pr; include the target in the brief for a general session.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.Route Mo’s traffic through a tunnel started with
qa tunnel start. Required when the target runs on
your machine or a private network.Set testing effort to
low, medium, high, or max. The default testing
budgets are 15, 30, 60, and 120 minutes, respectively. Time spent clarifying
the request does not count toward the session’s testing time. See choose an
effort.Browser interaction speed:
default (the default) or human. human adds
250 ms between steps in a batch and sets the default typing delay to 100 ms
per keystroke. The first step and single-step calls have no added step delay.
Explicit typing-step delays override the default.Skip Mo’s observed test cases, which are recorded in the background from agent
activity. Mo still tests, reports bugs and can report test cases directly.
Choose
regular or large for the session’s root browser and delegated
browsers. Use large for CPU-intensive apps. --webgl overrides this option
and selects large. Cannot be combined with --platform.Enable WebGL support for apps that render 3D graphics. WebGL is in alpha.
Rendering uses the CPU, so graphics-heavy apps may run slowly. Applies to the
session’s root browser and delegated browsers. Selects the
large browser
size, overriding --size regular. Cannot be combined with --platform.Test a mobile build on
IOS or ANDROID instead of a browser. Requires Mo
mobile access, --channel, and --tag. Cannot be combined with --pr.Start in a named workspace environment. Mo sees variable names, descriptions,
and the literal
BASE_URL starting URL. Values are available during
execution.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.Copy one variable from your current shell environment into the session
environment. Repeatable. The command fails if the variable is not set.
Startup request ID for a general session. The CLI generates one when omitted.
If the start can’t be confirmed, pass the ID to
qa sessions recover instead of starting again. Not
supported with --pr.Output
The command prints one JSON object:sessionId for the other session commands. webUrl opens the session in
the dashboard. Older servers omit createdAt.
With --tunnel, the object also has diagnostics when a URL in the brief or
--url is not covered by the tunnel. Each entry has code
(MO_TUNNEL_TARGET_NOT_COVERED), target, configuredTargets, retryable,
and message; the CLI also prints each code and message to stderr.
Examples
Give a bug bash more time and sub-agents:owner/repo#number also works.
PR sessions use the workspace’s GitHub App access and show a PR badge in Mo.
The session tests the commit captured at startup. Supply --url when you know
the target deployment, even when its host is not Vercel, Cloudflare, or Netlify.
Mo focuses on the changed and affected flows. Its PR plan allows about 20
minutes elapsed, including preparation, reproduction, and reporting. Set a
different scope or duration in the brief when needed. This is a planning
ceiling, not a hard runtime cutoff.
Mo prepares a shallow checkout of the captured commit in the background. It
reuses the workspace snapshot when available and fetches the requested revision.
Mo can inspect the preview while source downloads. GitHub tools remain available
for older commits and other branches.
Mo posts a review comment with the session link, then updates it with the
results. Each PR session gets a separate review. A new session collapses earlier
Mo reviews as Outdated, with their session and report links preserved. On
the same commit, the Mo check tracks the latest request; earlier attempts stay
in its history. Installations with Issues: write alone receive PR comments
with the same updates and supersession behavior.
Clean runs that include a local patch finish with a neutral GitHub check,
because they do not verify the remote commit alone.
Session starts are submitted once. If Mo cannot confirm startup after a
connection failure, check your sessions in Mo before retrying.
Commit and push local changes before starting when you have permission. If
pushing is prohibited, send a reviewed patch from a checkout at the published PR
head:
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.
Mo investigates the PR revision plus that patch and reports the local changes
separately from the published SHA.
Start a session and wait up to 290 seconds for output:
qa wait to wait for the session and its
sub-agents to finish or ask for input.
Give Mo credentials from a local .env file without putting them in the brief: