CLI

Use the m8tes CLI to inspect agents, run tasks, manage app connections, and debug account state from your terminal.

Installation

Or skip login and pass your API key directly: m8tes --api-key m8_your_key_here agent task "Do something".

Everyday commands

mate is a permanent alias (m8tes mate task … still works). Have more than one agent? Pass its id: m8tes agent task 7 "Prepare the weekly report". Inside a chat session use /exit, /clear, or /resume <run_id>; m8tes agent chat --resume 42 reopens a previous run.

Command reference

Auth

Terminal

Tasks and output formats

Terminal

Reusable task definitions attach to agents and trigger manually, on a schedule, via webhook, or by email:

Terminal

Agent management

Terminal

Run inspection

Terminal

set-permission-mode also works while a run is paused. Switching to autonomous resumes pending tool approvals, but AskUserQuestion still waits for runs.answer().

App connections

Terminal

Most commands have short aliases: m8tes m t "Do X" for agent task (m = agent alias), m8tes m ch for chat, m8tes r ls for run list, m8tes a l for auth login, m8tes task x for task execute.

Development Mode

Override the local port with M8TES_PORT=9000.

CLI vs SDK

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

Next: Quickstart · Errors