What does the Mmx Cli AI skill do?

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

Why use Mmx Cli on TypingMind?

Because you install it once and use it with any model. Mmx Cli is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Mmx Cli in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/MiniMax-AI/skills/tree/main/skills/minimax-multimodal-toolkit. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Mmx Cli?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Mmx Cli?

As many as you like. As long as a model supports skills, you can use Mmx Cli with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Mmx Cli AI skill free?

Yes. It is published on GitHub by MiniMax-AI under the MIT license. You only pay your own AI provider for the tokens you use.

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

Mmx Cli by MiniMax-AI — AI Skill for Any LLM

MiniMax CLI — Agent Skill Guide

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

Prerequisites

bash
# Install
npm install -g mmx-cli

# Auth (persisted to ~/.mmx/credentials.json)
mmx auth login --api-key sk-xxxxx

# 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-M2.7.

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

Flag	Type	Description
`--message <text>`	string, required, repeatable	Message text. Prefix with `role:` to set role (e.g. `"system:You are helpful"`, `"user:Hello"`)
`--messages-file <path>`	string	JSON file with messages array. Use `-` for stdin
`--system <text>`	string	System prompt
`--model <model>`	string	Model ID (default: `MiniMax-M2.7`)
`--max-tokens <n>`	number	Max tokens (default: 4096)
`--temperature <n>`	number	Sampling temperature (0.0, 1.0]
`--top-p <n>`	number	Nucleus sampling threshold
`--stream`	boolean	Stream tokens (default: on in TTY)
`--tool <json-or-path>`	string, repeatable	Tool definition JSON or file path

bash
# Single message
mmx text chat --message "user:What is MiniMax?" --output json --quiet

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

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

stdout: response text (text mode) or full response object (json mode).

image generate

Generate images. Model: image-01.

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

Flag	Type	Description
`--prompt <text>`	string, required	Image description
`--aspect-ratio <ratio>`	string	e.g. `16:9`, `1:1`
`--n <count>`	number	Number of images (default: 1)
`--subject-ref <params>`	string	Subject reference: `type=character,image=path-or-url`
`--out-dir <dir>`	string	Download images to directory
`--out-prefix <prefix>`	string	Filename prefix (default: `image`)

bash
mmx image generate --prompt "A cat in a spacesuit" --output json --quiet
# stdout: image URLs (one per line in quiet mode)

mmx image generate --prompt "Logo" --n 3 --out-dir ./gen/ --quiet
# stdout: saved file paths (one per line)

video generate

Generate video. Default model: MiniMax-Hailuo-2.3. This is an async task — by default it polls until completion.

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

Flag	Type	Description
`--prompt <text>`	string, required	Video description
`--model <model>`	string	`MiniMax-Hailuo-2.3` (default) or `MiniMax-Hailuo-2.3-Fast`
`--first-frame <path-or-url>`	string	First frame image
`--callback-url <url>`	string	Webhook URL for completion
`--download <path>`	string	Save video to specific file
`--async`	boolean	Return task ID immediately
`--no-wait`	boolean	Same as `--async`
`--poll-interval <seconds>`	number	Polling interval (default: 5)

bash
# Non-blocking: get task ID
mmx video generate --prompt "A robot." --async --quiet
# stdout: {"taskId":"..."}

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

video task get

Query status of a video generation task.

bash
mmx video task get --task-id <id> [--output json]

video download

Download a completed video by task ID.

bash
mmx video download --file-id <id> [--out <path>]

speech synthesize

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

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

Flag	Type	Description
`--text <text>`	string	Text to synthesize
`--text-file <path>`	string	Read text from file. Use `-` for stdin
`--model <model>`	string	`speech-2.8-hd` (default), `speech-2.6`, `speech-02`
`--voice <id>`	string	Voice ID (default: `English_expressive_narrator`)
`--speed <n>`	number	Speed multiplier
`--volume <n>`	number	Volume level
`--pitch <n>`	number	Pitch adjustment
`--format <fmt>`	string	Audio format (default: `mp3`)
`--sample-rate <hz>`	number	Sample rate (default: 32000)
`--bitrate <bps>`	number	Bitrate (default: 128000)
`--channels <n>`	number	Audio channels (default: 1)
`--language <code>`	string	Language boost
`--subtitles`	boolean	Include subtitle timing data
`--pronunciation <from/to>`	string, repeatable	Custom pronunciation
`--sound-effect <effect>`	string	Add sound effect
`--out <path>`	string	Save audio to file
`--stream`	boolean	Stream raw audio to stdout

bash
mmx speech synthesize --text "Hello world" --out hello.mp3 --quiet
# stdout: hello.mp3

echo "Breaking news." | mmx speech synthesize --text-file - --out news.mp3

music generate

Generate music. Model: music-2.5. Responds well to rich, structured descriptions.

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

Flag	Type	Description
`--prompt <text>`	string	Music style description (can be detailed)
`--lyrics <text>`	string	Song lyrics with structure tags. Use `"\u65e0\u6b4c\u8bcd"` for instrumental. Cannot be used with `--instrumental`
`--lyrics-file <path>`	string	Read lyrics from file. Use `-` for stdin
`--vocals <text>`	string	Vocal style, e.g. `"warm male baritone"`, `"bright female soprano"`, `"duet with harmonies"`
`--genre <text>`	string	Music genre, e.g. folk, pop, jazz
`--mood <text>`	string	Mood or emotion, e.g. warm, melancholic, uplifting
`--instruments <text>`	string	Instruments to feature, e.g. `"acoustic guitar, piano"`
`--tempo <text>`	string	Tempo description, e.g. fast, slow, moderate
`--bpm <number>`	number	Exact tempo in beats per minute
`--key <text>`	string	Musical key, e.g. C major, A minor, G sharp
`--avoid <text>`	string	Elements to avoid in the generated music
`--use-case <text>`	string	Use case context, e.g. `"background music for video"`, `"theme song"`
`--structure <text>`	string	Song structure, e.g. `"verse-chorus-verse-bridge-chorus"`
`--references <text>`	string	Reference tracks or artists, e.g. `"similar to Ed Sheeran"`
`--extra <text>`	string	Additional fine-grained requirements
`--instrumental`	boolean	Generate instrumental music (no vocals). Cannot be used with `--lyrics` or `--lyrics-file`
`--aigc-watermark`	boolean	Embed AI-generated content watermark
`--format <fmt>`	string	Audio format (default: `mp3`)
`--sample-rate <hz>`	number	Sample rate (default: 44100)
`--bitrate <bps>`	number	Bitrate (default: 256000)
`--out <path>`	string	Save audio to file
`--stream`	boolean	Stream raw audio to stdout

At least one of --prompt or --lyrics is required.

bash
# Simple usage
mmx music generate --prompt "Upbeat pop" --lyrics "La la la..." --out song.mp3 --quiet

# Detailed prompt with vocal characteristics
mmx music generate --prompt "Warm morning folk" \
  --vocals "male and female duet, harmonies in chorus" \
  --instruments "acoustic guitar, piano" \
  --bpm 95 \
  --lyrics-file song.txt \
  --out duet.mp3

# Instrumental (use --instrumental flag)
mmx music generate --prompt "Cinematic orchestral, building tension" --instrumental --out bgm.mp3

vision describe

Image understanding via VLM. Provide either --image or --file-id, not both.

bash
mmx vision describe (--image <path-or-url> | --file-id <id>) [flags]

Flag	Type	Description
`--image <path-or-url>`	string	Local path or URL (auto base64-encoded)
`--file-id <id>`	string	Pre-uploaded file ID (skips base64)
`--prompt <text>`	string	Question about the image (default: `"Describe the image."`)

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

stdout: description text (text mode) or full response (json mode).

search query

Web search via MiniMax.

bash
mmx search query --q <query>

Flag	Type	Description
`--q <query>`	string, required	Search query

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

quota show

Display Token Plan usage and remaining quotas.

bash
mmx quota show [--output json]

Tool Schema Export

Export all commands as Anthropic/OpenAI-compatible JSON tool schemas:

bash
# All tool-worthy commands (excludes auth/config/update)
mmx config export-schema

# Single command
mmx config export-schema --command "video generate"

Use this to dynamically register mmx commands as tools in your agent framework.

Exit Codes

Code	Meaning
0	Success
1	General error
2	Usage error (bad flags, missing args)
3	Authentication error
4	Quota exceeded
5	Timeout
10	Content filter triggered

Piping Patterns

bash
# stdout is always clean data — safe to pipe
mmx text chat --message "Hi" --output json | jq '.content'

# stderr has progress/spinners — discard if needed
mmx video generate --prompt "Waves" 2>/dev/null

# 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

Configuration Precedence

CLI flags → environment variables → ~/.mmx/config.json → defaults.

bash
# Persistent config
mmx config set --key region --value cn
mmx config show

# Environment
export MINIMAX_API_KEY=sk-xxxxx
export MINIMAX_REGION=cn

Publisher	MiniMax-AI
Repository	`skills`
Skill name	`mmx-cli`
Stars	13.6K
Forks	1.2K
Bundled files	Instructions only
License	MIT
Links	Skill source Repository

Mmx Cli

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

MiniMax CLI — Agent Skill Guide

Prerequisites

Agent Flags

Commands

text chat

image generate

video generate

video task get

video download

speech synthesize

music generate

vision describe

search query

quota show

Tool Schema Export

Exit Codes

Piping Patterns

Configuration Precedence

Frequently asked questions

Set up your own AI workspace now

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

MiniMax CLI — Agent Skill Guide

Prerequisites

Agent Flags

Commands

text chat

image generate

video generate

video task get

video download

speech synthesize

music generate

vision describe

search query

quota show

Tool Schema Export

Exit Codes

Piping Patterns

Configuration Precedence

Frequently asked questions

Related AI Skills

Set up your own AI workspace now