# Mmx CLI

Use mmx to generate text, images, video, and speech, and to transcribe audio, via the...

- Repository: https://github.com/MiniMax-AI/cli (2209 stars)
- Category: Media
- License: see repository
- Last updated: 2026-10-19
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add MiniMax-AI/cli --skill mmx-cli -g -a claude-code -y`
Codex: `npx skills add MiniMax-AI/cli --skill mmx-cli -g -a codex -y`
Cursor: `npx skills add MiniMax-AI/cli --skill mmx-cli -g -a cursor -y`
Gemini CLI: `npx skills add MiniMax-AI/cli --skill mmx-cli -g -a gemini-cli -y`

## Description

Use mmx to generate text, images, video, and speech, and to transcribe audio, via the MiniMax AI platform. Use when the user wants to create media content, chat with MiniMax models, transcribe audio to text, perform web search, or manage MiniMax API resources from the terminal.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# MiniMax CLI, Agent Skill Guide

Use `mmx` to generate text, images, video, speech, transcribe audio, and perform web search via the MiniMax AI platform.

## Prerequisites

```bash
# Install
npm install -g mmx-cli

# Auth (OAuth persists to ~/.mmx/credentials.json, API key persists to ~/.mmx/config.json)
mmx auth login --api-key sk-xxxxx

# Verify active auth source
mmx auth status

# Or pass per-call
mmx text chat --api-key sk-xxxxx --message "Hello"
```

Region is auto-detected. Override with `--region global` or `--region cn`.

---

## Agent Flags

Always use these flags in non-interactive (agent/CI) contexts:

| Flag | Purpose |
|---|---|
| `--non-interactive` | Fail fast on missing args instead of prompting |
| `--quiet` | Suppress spinners/progress; stdout is pure data |
| `--output json` | Machine-readable JSON output |
| `--async` | Return task ID immediately (video generation) |
| `--dry-run` | Preview the API request without executing |
| `--yes` | Skip confirmation prompts |

---

## Commands

### text chat

Chat completion. Default model: `MiniMax-M3.1-Flash`. An explicit `--model` or saved `default-text-model` takes precedence. This model currently requires M Plan or MiniMax Code; with a pay-as-you-go key, use `--model MiniMax-M3`. Thinking is enabled by default with `max` effort. See the [model guide](https://platform.minimax.io/docs/guides/text-generation#agent).

```bash
mmx text chat --message <text> [flags]
```

The rest: https://github.com/MiniMax-AI/cli/blob/HEAD/skill/SKILL.md