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 @monitodev/cli

Authenticate:

monito auth login

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

First Commands

List your projects:

monito project list

Run all scenarios in a project:

monito project run <project-id>

View a test run with debug logs:

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

For AI Agents

Every command supports --json for structured output:

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

JSON data and typed error envelopes go to stdout; human-readable text and progress go to stderr. Stable exit codes distinguish test failures from authentication, validation, credit, timeout, network, server, and conflict errors. See JSON output for the complete contract.

Set the MONITO_TOKEN environment variable to skip interactive login:

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