{"id":"4fe07e72-4960-40bd-ad56-f4315f8b0ea9","shortId":"4cAa9h","kind":"skill","title":"mmx-cli","tagline":"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.","description":"# MiniMax CLI — Agent Skill Guide\n\nUse `mmx` to generate text, images, video, speech, music, and perform web search via the MiniMax AI platform.\n\n## Prerequisites\n\n```bash\n# Install\nnpm install -g mmx-cli\n\n# Auth (OAuth persists to ~/.mmx/credentials.json, API key persists to ~/.mmx/config.json)\nmmx auth login --api-key sk-xxxxx\n\n# Verify active auth source\nmmx auth status\n\n# Or pass per-call\nmmx text chat --api-key sk-xxxxx --message \"Hello\"\n```\n\nRegion is auto-detected. Override with `--region global` or `--region cn`.\n\n---\n\n## Agent Flags\n\nAlways use these flags in non-interactive (agent/CI) contexts:\n\n| Flag | Purpose |\n|---|---|\n| `--non-interactive` | Fail fast on missing args instead of prompting |\n| `--quiet` | Suppress spinners/progress; stdout is pure data |\n| `--output json` | Machine-readable JSON output |\n| `--async` | Return task ID immediately (video generation) |\n| `--dry-run` | Preview the API request without executing |\n| `--yes` | Skip confirmation prompts |\n\n---\n\n## Commands\n\n### text chat\n\nChat completion. Default model: `MiniMax-M2.7`.\n\n```bash\nmmx text chat --message <text> [flags]\n```\n\n```bash\n# Single message\nmmx text chat --message \"user:What is MiniMax?\" --output json --quiet\n\n# Multi-turn with system prompt\nmmx text chat \\\n  --system \"You are a coding assistant.\" \\\n  --message \"user:Write fizzbuzz in Python\" \\\n  --output json\n\n# From file\ncat conversation.json | mmx text chat --messages-file - --output json\n```\n\n---\n\n### image generate\n\nGenerate images. Model: `image-01`.\n\n```bash\nmmx image generate --prompt <text> [flags]\n```\n\n```bash\nmmx image generate --prompt \"A cat in a spacesuit\" --output json --quiet\nmmx image generate --prompt \"Logo\" --n 3 --out-dir ./gen/ --quiet\n```\n\n---\n\n### video generate\n\nGenerate video. Default model: `MiniMax-Hailuo-2.3`. Async task — polls until completion by default.\n\n```bash\nmmx video generate --prompt <text> [flags]\n```\n\n```bash\n# Non-blocking: get task ID\nmmx video generate --prompt \"A robot.\" --async --quiet\n\n# Blocking: wait and save file\nmmx video generate --prompt \"Ocean waves.\" --download ocean.mp4 --quiet\n```\n\n---\n\n### speech synthesize\n\nText-to-speech. Default model: `speech-2.8-hd`. Max 10k chars.\n\n```bash\nmmx speech synthesize --text <text> [flags]\n```\n\n```bash\nmmx speech synthesize --text \"Hello world\" --out hello.mp3 --quiet\necho \"Breaking news.\" | mmx speech synthesize --text-file - --out news.mp3\n```\n\n---\n\n### music generate\n\nGenerate music. Model: `music-2.6-free`.\n\n```bash\nmmx music generate --prompt <text> [--lyrics <text>] [flags]\n```\n\n```bash\n# Instrumental\nmmx music generate --prompt \"Cinematic orchestral, building tension\" --instrumental --out bgm.mp3 --quiet\n\n# With auto-generated lyrics\nmmx music generate --prompt \"Upbeat pop about summer\" --lyrics-optimizer --out summer.mp3 --quiet\n```\n\n---\n\n### search query\n\nWeb search via MiniMax.\n\n```bash\nmmx search query --q \"MiniMax AI\" --output json --quiet\n```\n\n---\n\n### vision describe\n\nImage understanding via VLM.\n\n```bash\nmmx vision describe --image photo.jpg --prompt \"What breed?\" --output json\n```\n\n---\n\n## Piping Patterns\n\n```bash\n# Chain: generate image → describe it\nURL=$(mmx image generate --prompt \"A sunset\" --quiet)\nmmx vision describe --image \"$URL\" --quiet\n\n# Async video workflow\nTASK=$(mmx video generate --prompt \"A robot\" --async --quiet | jq -r '.taskId')\nmmx video task get --task-id \"$TASK\" --output json\nmmx video download --task-id \"$TASK\" --out robot.mp4\n```\n\n---\n\n## Exit Codes\n\n| Code | Meaning |\n|---|---|\n| 0 | Success |\n| 1 | General error |\n| 2 | Usage error |\n| 3 | Authentication error |\n| 4 | Quota exceeded |\n| 5 | Timeout |\n| 10 | Content filter triggered |\n\n---\n\n## Limitations\n\n- Requires a configured MiniMax account and valid authentication before any API-backed command will work.\n- Media-generation tasks can be async, quota-limited, or region-constrained; agents should handle delayed completion and provider-side failures explicitly.\n- This skill documents CLI usage only and does not replace provider policy review, content-safety checks, or downstream file validation.","tags":["mmx","cli","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-mmx-cli","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/mmx-cli","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34666 github stars · SKILL.md body (4,095 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-23T06:51:34.485Z","embedding":null,"createdAt":"2026-04-18T21:40:53.300Z","updatedAt":"2026-04-23T06:51:34.485Z","lastSeenAt":"2026-04-23T06:51:34.485Z","tsv":"'-01':260 '-2.6':391 '-2.8':353 '/.mmx/config.json':84 '/.mmx/credentials.json':79 '/gen':290 '0':526 '1':528 '10':542 '10k':356 '2':531 '2.3':301 '3':286,534 '4':537 '5':540 '7':198 'account':551 'activ':95 'agent':45,129,577 'agent/ci':139 'ai':17,64,445 'alway':131 'api':38,80,89,110,180,558 'api-back':557 'api-key':88,109 'arg':150 'assist':233 'async':168,302,328,488,498,569 'auth':75,86,96,99 'authent':535,554 'auto':120,416 'auto-detect':119 'auto-gener':415 'back':559 'bash':67,199,205,261,267,309,315,358,364,393,400,439,455,468 'bgm.mp3':412 'block':318,330 'break':375 'breed':463 'build':408 'call':105 'cat':244,273 'chain':469 'char':357 'chat':28,108,190,191,202,210,227,248 'check':604 'cinemat':406 'cli':3,44,74,591 'cn':128 'code':232,523,524 'command':188,560 'complet':192,306,581 'configur':549 'confirm':186 'constrain':576 'content':27,543,602 'content-safeti':601 'context':140 'conversation.json':245 'creat':25 'data':160 'default':193,296,308,350 'delay':580 'describ':450,458,472,484 'detect':121 'dir':289 'document':590 'download':341,515 'downstream':606 'dri':176 'dry-run':175 'echo':374 'error':530,533,536 'exceed':539 'execut':183 'exit':522 'explicit':587 'fail':146 'failur':586 'fast':147 'file':243,251,334,382,607 'filter':544 'fizzbuzz':237 'flag':130,134,141,204,266,314,363,399 'free':392 'g':71 'general':529 'generat':7,51,174,255,256,264,270,282,293,294,312,324,337,386,387,396,404,417,421,470,477,494,565 'get':319,506 'global':125 'guid':47 'hailuo':300 'handl':579 'hd':354 'hello':116,369 'hello.mp3':372 'id':171,321,509,518 'imag':9,53,254,257,259,263,269,281,451,459,471,476,485 'immedi':172 'instal':68,70 'instead':151 'instrument':401,410 'interact':138,145 'jq':500 'json':162,166,217,241,253,278,447,465,512 'key':81,90,111 'limit':546,572 'login':87 'logo':284 'lyric':398,418,428 'lyrics-optim':427 'm2':197 'machin':164 'machine-read':163 'manag':36 'max':355 'mean':525 'media':26,564 'media-gener':563 'messag':115,203,207,211,234,250 'messages-fil':249 'minimax':16,30,37,43,63,196,215,299,438,444,550 'minimax-hailuo':298 'minimax-m2':195 'miss':149 'mmx':2,5,49,73,85,98,106,200,208,225,246,262,268,280,310,322,335,359,365,377,394,402,419,440,456,475,482,492,503,513 'mmx-cli':1,72 'model':31,194,258,297,351,389 'multi':220 'multi-turn':219 'music':13,56,385,388,390,395,403,420 'n':285 'news':376 'news.mp3':384 'non':137,144,317 'non-block':316 'non-interact':136,143 'npm':69 'oauth':76 'ocean':339 'ocean.mp4':342 'optim':429 'orchestr':407 'out-dir':287 'output':161,167,216,240,252,277,446,464,511 'overrid':122 'pass':102 'pattern':467 'per':104 'per-cal':103 'perform':32,58 'persist':77,82 'photo.jpg':460 'pipe':466 'platform':18,65 'polici':599 'poll':304 'pop':424 'prerequisit':66 'preview':178 'prompt':153,187,224,265,271,283,313,325,338,397,405,422,461,478,495 'provid':584,598 'provider-sid':583 'pure':159 'purpos':142 'python':239 'q':443 'queri':434,442 'quiet':154,218,279,291,329,343,373,413,432,448,481,487,499 'quota':538,571 'quota-limit':570 'r':501 'readabl':165 'region':117,124,127,575 'region-constrain':574 'replac':597 'request':181 'requir':547 'resourc':39 'return':169 'review':600 'robot':327,497 'robot.mp4':521 'run':177 'safeti':603 'save':333 'search':34,60,433,436,441 'side':585 'singl':206 'sk':92,113 'sk-xxxxx':91,112 'skill':46,589 'skill-mmx-cli' 'skip':185 'sourc':97 'source-sickn33' 'spacesuit':276 'speech':11,55,344,349,352,360,366,378 'spinners/progress':156 'status':100 'stdout':157 'success':527 'summer':426 'summer.mp3':431 'sunset':480 'suppress':155 'synthes':345,361,367,379 'system':223,228 'task':170,303,320,491,505,508,510,517,519,566 'task-id':507,516 'taskid':502 'tension':409 'termin':42 'text':8,52,107,189,201,209,226,247,347,362,368,381 'text-fil':380 'text-to-speech':346 'timeout':541 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'trigger':545 'turn':221 'understand':452 'upbeat':423 'url':474,486 'usag':532,592 'use':4,19,48,132 'user':22,212,235 'valid':553,608 'verifi':94 'via':14,61,437,453 'video':10,54,173,292,295,311,323,336,489,493,504,514 'vision':449,457,483 'vlm':454 'wait':331 'want':23 'wave':340 'web':33,59,435 'without':182 'work':562 'workflow':490 'world':370 'write':236 'xxxxx':93,114 'yes':184","prices":[{"id":"2d4c39ac-f86b-4047-af67-daa3ad2b48ef","listingId":"4fe07e72-4960-40bd-ad56-f4315f8b0ea9","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:40:53.300Z"}],"sources":[{"listingId":"4fe07e72-4960-40bd-ad56-f4315f8b0ea9","source":"github","sourceId":"sickn33/antigravity-awesome-skills/mmx-cli","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/mmx-cli","isPrimary":false,"firstSeenAt":"2026-04-18T21:40:53.300Z","lastSeenAt":"2026-04-23T06:51:34.485Z"}],"details":{"listingId":"4fe07e72-4960-40bd-ad56-f4315f8b0ea9","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"mmx-cli","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34666,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-23T06:41:03Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"52931c9cb67ceaab38fe509538f957fae8324414","skill_md_path":"skills/mmx-cli/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/mmx-cli"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"mmx-cli","description":"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."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/mmx-cli"},"updatedAt":"2026-04-23T06:51:34.485Z"}}