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.

Using Claude, Cursor, ChatGPT or another AI tool? Connect the MCP server at https://www.monito.dev/api/mcp to check deployed URLs through typed tools, with nothing to install. Localhost checks and CI setup require the local MCP server (monito mcp) or the CLI.

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

Check a change on localhost:

monito check http://localhost:3000/signup "The form rejects a malformed email" --json

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

Agents in MCP clients should use the MCP server. For scripts, CI and agents that work through a shell, 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