CLI

The m8tes CLI lets you manage teammates and run tasks directly from your terminal.

Installation

Verify the install:

Authentication

Log in to save your credentials locally:

You'll be prompted for your email and password. Credentials are stored securely for future sessions.

Other auth commands:

Or skip login and pass your API key directly:

Running Tasks

Execute a one-off task with a teammate:

Output Formats

Interactive Chat

Start a multi-turn conversation:

Session commands:

Teammate Management

Task Management

Create reusable task definitions attached to teammates. Tasks can be triggered manually, on a schedule, via webhook, or by email.

Run Inspection

View details about past runs — conversation history, token usage, and tool executions.

Development Mode

Use --dev to target your local backend:

This connects to http://127.0.0.1:8000 by default. Override the port with M8TES_PORT:

Or point to any backend with --base-url:

Command Aliases

Most commands have short aliases for faster typing:

CLI vs SDK

The CLI uses the same backend as the Python SDK. Choose based on your workflow: