Monito CLI

The Monito CLI lets you manage projects, test scenarios, and runs from the terminal. It's designed for both human users and AI agents.

Quick Start

Install globally:

npm install -g @monito/cli

Authenticate:

monito-cli auth login

This opens your browser for OAuth authentication. Once complete, your token is stored locally.

First Commands

List your projects:

monito-cli project list

Run all scenarios in a project:

monito-cli project run <project-id>

View a test run with debug logs:

monito-cli run view <run-id>
monito-cli run logs <run-id>

For AI Agents

Every command supports --json for structured output:

monito-cli project list --json
monito-cli run view <id> --json

JSON data goes to stdout, human-readable text to stderr. Exit codes: 0 = success, 1 = test failed, 2 = error.

Set the MONITO_TOKEN environment variable to skip interactive login:

export MONITO_TOKEN="your-token"
monito-cli project list --json