Skip to main content
Start a session by giving Mo a brief in plain language. The command returns as soon as the session exists; Mo keeps working in the cloud. Use mo read to follow its output.

Arguments

string
required
The brief. Include the target URL, credentials or how to get them, and any boundaries Mo must respect.

Options

string
Route Mo’s traffic through a tunnel started with mo tunnel start. Required when the target runs on your machine or a private network.
integer
Maximum number of sub-agents Mo runs at the same time. Must be a positive integer. The organization limit caps the value.
string
How specific Mo’s explore-agent test discovery should be: low, medium, or high. Defaults to high.
string
Start in a named workspace environment. Its non-secret variables are visible to the session, and a BASE_URL variable sets the starting URL.
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.
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:
Keep sessionId for the other session commands. webUrl opens the session in the dashboard.

Examples

Start a session and follow it until Mo finishes or asks a question:
Give Mo credentials from a local .env file without putting them in the brief:
Test a local build through a tunnel: