scenario

scenario list

List test scenarios, optionally filtered by project.

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

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

scenario view

View scenario details.

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

scenario create

Create a test scenario.

monito-cli 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
`--model <model>`	No	AI model: `claude-opus-4-6`, `claude-sonnet-4-6`, `claude-haiku-4-5`
`--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-cli 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
`--model <model>`	AI model
`--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-cli scenario delete <id> --yes

scenario run

Run a single test scenario.

monito-cli scenario run <id>              # waits for completion
monito-cli scenario run <id> --no-wait    # returns immediately
monito-cli 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.