How do I install the Mmx CLI skill?

Run npx skillmds add antigravity/mmx-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Mmx CLI skill do?

Generate text, images, video, speech, and music via the MiniMax AI platform using the mmx CLI. It is listed under Integrations & APIs, AI & ML, Image & Video Generation, Speech & Audio on SkillMD.

Is Mmx CLI safe to use?

SkillMD's automated safety review verdict for this skill is CAUTION. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mmx CLI?

This skill is tagged as working with Claude Code, Cursor, OpenAI Codex, Gemini, Antigravity. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mmx CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mmx CLI?

Antigravity Skills (@antigravity) published this skill. Their other Agent Skills are listed on their SkillMD profile.

MiniMax CLI — Agent Skill Guide

Name: Mmx CLI
Rating: 4.5 (4 reviews)
Author: Antigravity Skills

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

When to Use

Use this skill when the user wants to generate or inspect text, images, video, speech, music, web-search results, or MiniMax API resources through the mmx terminal CLI.

Prerequisites

# 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. Pass --model MiniMax-M2.7 for the previous-generation default when reproducing older outputs.

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

# Single message (uses MiniMax-M3 by default)
mmx text chat --message "user:What is MiniMax?" --output json --quiet

# Multi-turn with system prompt
mmx text chat \
  --system "You are a coding assistant." \
  --message "user:Write fizzbuzz in Python" \
  --output json

# Pin to the previous-generation model
mmx text chat --model MiniMax-M2.7 --message "user:Hello" --output json

# From file
cat conversation.json | mmx text chat --messages-file - --output json

image generate

Generate images. Model: image-01.

mmx image generate --prompt <text> [flags]

mmx image generate --prompt "A cat in a spacesuit" --output json --quiet
mmx image generate --prompt "Logo" --n 3 --out-dir ./gen/ --quiet

video generate

Generate video. Default model: MiniMax-Hailuo-2.3. Async task — polls until completion by default.

mmx video generate --prompt <text> [flags]

# Non-blocking: get task ID
mmx video generate --prompt "A robot." --async --quiet

# Blocking: wait and save file
mmx video generate --prompt "Ocean waves." --download ocean.mp4 --quiet

speech synthesize

Text-to-speech. Default model: speech-2.8-hd. Max 10k chars.

mmx speech synthesize --text <text> [flags]

mmx speech synthesize --text "Hello world" --out hello.mp3 --quiet
echo "Breaking news." | mmx speech synthesize --text-file - --out news.mp3

music generate

Generate music. Model: music-2.6-free.

mmx music generate --prompt <text> [--lyrics <text>] [flags]

# Instrumental
mmx music generate --prompt "Cinematic orchestral, building tension" --instrumental --out bgm.mp3 --quiet

# With auto-generated lyrics
mmx music generate --prompt "Upbeat pop about summer" --lyrics-optimizer --out summer.mp3 --quiet

search query

Web search via MiniMax.

mmx search query --q "MiniMax AI" --output json --quiet

vision describe

Image understanding via VLM.

mmx vision describe --image photo.jpg --prompt "What breed?" --output json

Piping Patterns

# Chain: generate image → describe it
URL=$(mmx image generate --prompt "A sunset" --quiet)
mmx vision describe --image "$URL" --quiet

# Async video workflow
TASK=$(mmx video generate --prompt "A robot" --async --quiet | jq -r '.taskId')
mmx video task get --task-id "$TASK" --output json
mmx video download --task-id "$TASK" --out robot.mp4

Exit Codes

Code	Meaning
0	Success
1	General error
2	Usage error
3	Authentication error
4	Quota exceeded
5	Timeout
10	Content filter triggered

Limitations

Requires a configured MiniMax account and valid authentication before any API-backed command will work.
Media-generation tasks can be async, quota-limited, or region-constrained; agents should handle delayed completion and provider-side failures explicitly.
This skill documents CLI usage only and does not replace provider policy review, content-safety checks, or downstream file validation.

--- name: mmx-cli description: Generate text, images, video, speech, and music via the MiniMax AI platform using the mmx CLI. --- # MiniMax CLI — Agent Skill Guide Use `mmx` to generate text, images, video, speech, music, and perform web search via the MiniMax AI platform. ## When to Use Use this skill when the user wants to generate or inspect text, images, video, speech, music, web-search results, or MiniMax API resources through the `mmx` terminal CLI. ## 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`. Pass `--model MiniMax-M2.7` for the previous-generation default when reproducing older outputs. ```bash mmx text chat --message <text> [flags] ``` ```bash # Single message (uses MiniMax-M3 by default) mmx text chat --message "user:What is MiniMax?" --output json --quiet # Multi-turn with system prompt mmx text chat \ --system "You are a coding assistant." \ --message "user:Write fizzbuzz in Python" \ --output json # Pin to the previous-generation model mmx text chat --model MiniMax-M2.7 --message "user:Hello" --output json # From file cat conversation.json | mmx text chat --messages-file - --output json ``` --- ### image generate Generate images. Model: `image-01`. ```bash mmx image generate --prompt <text> [flags] ``` ```bash mmx image generate --prompt "A cat in a spacesuit" --output json --quiet mmx image generate --prompt "Logo" --n 3 --out-dir ./gen/ --quiet ``` --- ### video generate Generate video. Default model: `MiniMax-Hailuo-2.3`. Async task — polls until completion by default. ```bash mmx video generate --prompt <text> [flags] ``` ```bash # Non-blocking: get task ID mmx video generate --prompt "A robot." --async --quiet # Blocking: wait and save file mmx video generate --prompt "Ocean waves." --download ocean.mp4 --quiet ``` --- ### speech synthesize Text-to-speech. Default model: `speech-2.8-hd`. Max 10k chars. ```bash mmx speech synthesize --text <text> [flags] ``` ```bash mmx speech synthesize --text "Hello world" --out hello.mp3 --quiet echo "Breaking news." | mmx speech synthesize --text-file - --out news.mp3 ``` --- ### music generate Generate music. Model: `music-2.6-free`. ```bash mmx music generate --prompt <text> [--lyrics <text>] [flags] ``` ```bash # Instrumental mmx music generate --prompt "Cinematic orchestral, building tension" --instrumental --out bgm.mp3 --quiet # With auto-generated lyrics mmx music generate --prompt "Upbeat pop about summer" --lyrics-optimizer --out summer.mp3 --quiet ``` --- ### search query Web search via MiniMax. ```bash mmx search query --q "MiniMax AI" --output json --quiet ``` --- ### vision describe Image understanding via VLM. ```bash mmx vision describe --image photo.jpg --prompt "What breed?" --output json ``` --- ## Piping Patterns ```bash # Chain: generate image → describe it URL=$(mmx image generate --prompt "A sunset" --quiet) mmx vision describe --image "$URL" --quiet # Async video workflow TASK=$(mmx video generate --prompt "A robot" --async --quiet | jq -r '.taskId') mmx video task get --task-id "$TASK" --output json mmx video download --task-id "$TASK" --out robot.mp4 ``` --- ## Exit Codes | Code | Meaning | |---|---| | 0 | Success | | 1 | General error | | 2 | Usage error | | 3 | Authentication error | | 4 | Quota exceeded | | 5 | Timeout | | 10 | Content filter triggered | --- ## Limitations - Requires a configured MiniMax account and valid authentication before any API-backed command will work. - Media-generation tasks can be async, quota-limited, or region-constrained; agents should handle delayed completion and provider-side failures explicitly. - This skill documents CLI usage only and does not replace provider policy review, content-safety checks, or downstream file validation.

Mmx CLI