scenario

scenario list

List test scenarios, optionally filtered by project.

monito scenario list
monito scenario ls                        # alias
monito scenario list --project-id <id>    # filter by project
monito scenario list --json

Displays: ID, Name, URL, Model, Max Duration.

scenario view

View scenario details.

monito scenario view <id>
monito scenario view <id> --json

scenario create

Create a test scenario.

monito scenario create \
  --project-id <id> \
  --name "Login Flow" \
  --url "https://myapp.com/login" \
  --prompt "Test the login flow with valid credentials"

Flag	Required	Description
`--project-id <id>`	Yes	Project to add the scenario to
`--name <name>`	Yes	Scenario name
`--url <url>`	Yes	URL to test
`--prompt <prompt>`	Yes	Test instructions in plain English
`--intelligence <tier>`	No	`standard` (default) or `advanced`
`--max-duration <ms>`	No	Max duration in ms (60000–600000)
`--custom-instructions <text>`	No	Additional instructions for the AI agent
`--json`	No	Output as JSON

scenario update

Update a test scenario. Only provided values are changed.

monito scenario update <id> \
  --name "Updated Login Flow" \
  --prompt "Test login with invalid credentials and verify error message"

Flag	Description
`--name <name>`	Scenario name
`--url <url>`	URL to test
`--prompt <prompt>`	Test prompt
`--intelligence <tier>`	`standard` or `advanced`
`--max-duration <ms>`	Max duration in ms
`--custom-instructions <text>`	Custom instructions
`--json`	Output as JSON

scenario delete

Delete a scenario. Requires --yes to confirm.

monito scenario delete <id> --yes

scenario run

Run a single test scenario.

monito scenario run <id>              # waits for completion
monito scenario run <id> --no-wait    # returns immediately
monito scenario run <id> --json

By default, the CLI polls until the run completes and shows the result including status, duration, bug count, and cost.

Exit code 1 if the run fails or errors.

Check scenario instructions before spending a run. Runs locally, no credits. It flags a missing expected result, expectations the browser can't check ("works correctly"), passwords or tokens in the text, selectors, several flows in one scenario, unsupported placeholders, relative dates and hard-coded origins.

monito scenario lint <id>
monito scenario lint --prompt "Open /settings and change the name."
monito scenario lint --file scenario.txt --location /settings --json

Exit code 1 when any finding is an error.

scenario improve

Ask AI to rewrite a scenario so the agent can run and verify it reliably. Prints the changes and a diff; nothing is saved without --apply.

monito scenario improve <id>
monito scenario improve <id> --apply

Available when AI assist is enabled for your workspace.

On this page