Monito CLI

run

View test runs — list recent runs, view details, and read execution logs.

run list

List recent test runs.

monito run list
monito run ls                  # alias
monito run list --limit 50     # show more
monito run list --json

Displays: ID, Scenario, Project, Status, Duration, Bug count, Completed time.

Default limit is 20.

run view

View detailed information about a test run.

monito run view <id>
monito run view <id> --evidence
monito run view <id> --json
monito run view <id> --evidence --json
monito run view <id> --issue-markdown
monito run view <id> --issue-markdown --json

Shows all run fields including status, duration, cost, bug reports count, session ID, and error messages.

--evidence adds the verdict reason, full bug reports, failing network and console evidence, screenshot references, and event counts in one context-sized response. A failed run still exits with code 1.

--issue-markdown exports each bug as an issue body: title, description (when present), reproduction steps, expected and actual behavior, environment, tested URL, run report link, and the first unsigned screenshot link from a public report. Credentials, URL query strings and fragments, and masked values are omitted. Human output goes to stderr, with --- between issues; JSON output is { "runId": "…", "issues": [{ "bugReportId": "…", "markdown": "…" }] }. No bugs produces an empty issues array. This flag cannot be combined with --evidence or --require-verified; failed/error runs still exit 1.

run logs

Show execution logs for a test run.

monito run logs <id>
monito run logs <id> --json

In human mode, prints the raw log output to stderr. In JSON mode, wraps the logs in a JSON object:

{
  "id": "run-id",
  "logs": "..."
}

run diagnose

Ask AI why a run failed, errored or could not verify its result. It names the likely cause (the product, the environment or the test instructions) and, when the instructions caused it, proposes a fix.

monito run diagnose <id>
monito run diagnose <id> --apply   # save the suggested instructions
monito run diagnose <id> --json

Run Statuses

StatusDescription
pendingRun is queued
runningAI agent is actively testing
passedAll checks passed
failedOne or more checks failed or bugs found
errorRun encountered an error

Exit Codes

CodeMeaning
0Success (run passed or command completed)
1Test failure (run failed or errored)
2–8Typed CLI error; see JSON output

On this page