superacli 1.1.13 → 1.1.14

package/plugins/mmx/plugin.json

@@ -0,0 +1,413 @@
+{
+  "name": "mmx",
+  "version": "1.0.0",
+  "description": "MiniMax AI Platform CLI — text, image, video, speech, music, vision, and search generation",
+  "source": "https://github.com/MiniMax-AI/cli/",
+  "checks": [
+    { "type": "binary", "name": "mmx" }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "mmx",
+      "resource": "auth",
+      "action": "login",
+      "description": "Authenticate via OAuth or API key",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["auth", "login"],
+        "parseJson": false,
+        "missingDependencyHelp": "Run: npm install -g mmx-cli"
+      },
+      "args": [
+        { "name": "method", "type": "string", "required": false, "description": "Auth method: oauth, api-key", "flag": "--method" },
+        { "name": "api-key", "type": "string", "required": false, "description": "API key to store", "flag": "--api-key" },
+        { "name": "no-browser", "type": "boolean", "required": false, "description": "Use device-code flow instead of browser", "flag": "--no-browser" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "auth",
+      "action": "status",
+      "description": "Check authentication status",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["auth", "status"],
+        "parseJson": false,
+        "missingDependencyHelp": "Run: npm install -g mmx-cli"
+      },
+      "args": []
+    },
+    {
+      "namespace": "mmx",
+      "resource": "auth",
+      "action": "refresh",
+      "description": "Refresh OAuth credentials",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["auth", "refresh"],
+        "parseJson": false,
+        "missingDependencyHelp": "Run: npm install -g mmx-cli"
+      },
+      "args": []
+    },
+    {
+      "namespace": "mmx",
+      "resource": "auth",
+      "action": "logout",
+      "description": "Clear stored credentials",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["auth", "logout"],
+        "parseJson": false,
+        "missingDependencyHelp": "Run: npm install -g mmx-cli"
+      },
+      "args": []
+    },
+    {
+      "namespace": "mmx",
+      "resource": "text",
+      "action": "chat",
+      "description": "Send a chat completion request (MiniMax Messages API)",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["text", "chat"],
+        "positionalArgs": ["message"],
+        "jsonFlag": "--output",
+        "parseJson": true,
+        "missingDependencyHelp": "Run: mmx auth login --api-key sk-xxxxx"
+      },
+      "args": [
+        { "name": "message", "type": "string", "required": true, "description": "Message text (prefix role: to set role, e.g. assistant:Hi)", "flag": "--message" },
+        { "name": "model", "type": "string", "required": false, "description": "Model ID (default: MiniMax-M2.7)", "flag": "--model" },
+        { "name": "system", "type": "string", "required": false, "description": "System prompt", "flag": "--system" },
+        { "name": "messages-file", "type": "string", "required": false, "description": "JSON file with messages array (use - for stdin)", "flag": "--messages-file" },
+        { "name": "max-tokens", "type": "integer", "required": false, "description": "Maximum tokens to generate (default: 4096)", "flag": "--max-tokens" },
+        { "name": "temperature", "type": "number", "required": false, "description": "Sampling temperature (0.0, 1.0]", "flag": "--temperature" },
+        { "name": "top-p", "type": "number", "required": false, "description": "Nucleus sampling threshold", "flag": "--top-p" },
+        { "name": "stream", "type": "boolean", "required": false, "description": "Stream response tokens", "flag": "--stream" },
+        { "name": "output", "type": "string", "required": false, "description": "Output format: text, json", "flag": "--output" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "image",
+      "action": "generate",
+      "description": "Generate images (image-01 / image-01-live)",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["image", "generate"],
+        "parseJson": true,
+        "missingDependencyHelp": "Run: mmx auth login --api-key sk-xxxxx"
+      },
+      "args": [
+        { "name": "prompt", "type": "string", "required": true, "description": "Image description", "flag": "--prompt" },
+        { "name": "aspect-ratio", "type": "string", "required": false, "description": "Aspect ratio (e.g. 16:9, 1:1)", "flag": "--aspect-ratio" },
+        { "name": "n", "type": "integer", "required": false, "description": "Number of images to generate (default: 1)", "flag": "--n" },
+        { "name": "seed", "type": "integer", "required": false, "description": "Random seed for reproducible output", "flag": "--seed" },
+        { "name": "width", "type": "integer", "required": false, "description": "Custom width in pixels (512-2048, multiple of 8)", "flag": "--width" },
+        { "name": "height", "type": "integer", "required": false, "description": "Custom height in pixels (512-2048, multiple of 8)", "flag": "--height" },
+        { "name": "prompt-optimizer", "type": "boolean", "required": false, "description": "Automatically optimize the prompt", "flag": "--prompt-optimizer" },
+        { "name": "aigc-watermark", "type": "boolean", "required": false, "description": "Embed AI-generated content watermark", "flag": "--aigc-watermark" },
+        { "name": "subject-ref", "type": "string", "required": false, "description": "Subject reference (format: type=character,image=path-or-url)", "flag": "--subject-ref" },
+        { "name": "out-dir", "type": "string", "required": false, "description": "Download images to directory", "flag": "--out-dir" },
+        { "name": "out-prefix", "type": "string", "required": false, "description": "Filename prefix (default: image)", "flag": "--out-prefix" },
+        { "name": "output", "type": "string", "required": false, "description": "Output format: text, json", "flag": "--output" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "video",
+      "action": "generate",
+      "description": "Generate a video (T2V, I2V, S2V modes)",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["video", "generate"],
+        "parseJson": true,
+        "missingDependencyHelp": "Run: mmx auth login --api-key sk-xxxxx"
+      },
+      "args": [
+        { "name": "model", "type": "string", "required": false, "description": "Model ID (default: MiniMax-Hailuo-2.3)", "flag": "--model" },
+        { "name": "prompt", "type": "string", "required": true, "description": "Video description", "flag": "--prompt" },
+        { "name": "first-frame", "type": "string", "required": false, "description": "First frame image (I2V mode)", "flag": "--first-frame" },
+        { "name": "last-frame", "type": "string", "required": false, "description": "Last frame image (SEF mode, requires --first-frame)", "flag": "--last-frame" },
+        { "name": "subject-image", "type": "string", "required": false, "description": "Subject reference image (S2V mode)", "flag": "--subject-image" },
+        { "name": "callback-url", "type": "string", "required": false, "description": "Webhook URL for completion notification", "flag": "--callback-url" },
+        { "name": "download", "type": "string", "required": false, "description": "Save video to file on completion", "flag": "--download" },
+        { "name": "no-wait", "type": "boolean", "required": false, "description": "Return task ID immediately", "flag": "--no-wait" },
+        { "name": "async", "type": "boolean", "required": false, "description": "Return task ID immediately (agent/CI mode)", "flag": "--async" },
+        { "name": "poll-interval", "type": "integer", "required": false, "description": "Polling interval in seconds (default: 5)", "flag": "--poll-interval" },
+        { "name": "output", "type": "string", "required": false, "description": "Output format: text, json", "flag": "--output" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "video",
+      "action": "task-get",
+      "description": "Query video task status",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["video", "task", "get"],
+        "parseJson": true,
+        "missingDependencyHelp": "Run: mmx auth login --api-key sk-xxxxx"
+      },
+      "args": [
+        { "name": "task-id", "type": "string", "required": true, "description": "Video generation task ID", "flag": "--task-id" },
+        { "name": "output", "type": "string", "required": false, "description": "Output format: text, json", "flag": "--output" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "video",
+      "action": "download",
+      "description": "Download a completed video by file ID",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["video", "download"],
+        "parseJson": true,
+        "missingDependencyHelp": "Run: mmx auth login --api-key sk-xxxxx"
+      },
+      "args": [
+        { "name": "file-id", "type": "string", "required": true, "description": "File ID to download", "flag": "--file-id" },
+        { "name": "out", "type": "string", "required": true, "description": "Output file path", "flag": "--out" },
+        { "name": "output", "type": "string", "required": false, "description": "Output format: text, json", "flag": "--output" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "speech",
+      "action": "synthesize",
+      "description": "Text-to-speech synthesis (speech-2.8-hd / 2.6 / 02)",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["speech", "synthesize"],
+        "parseJson": false,
+        "missingDependencyHelp": "Run: mmx auth login --api-key sk-xxxxx"
+      },
+      "args": [
+        { "name": "model", "type": "string", "required": false, "description": "Model ID (default: speech-2.8-hd)", "flag": "--model" },
+        { "name": "text", "type": "string", "required": true, "description": "Text to synthesize", "flag": "--text" },
+        { "name": "text-file", "type": "string", "required": false, "description": "Read text from file (use - for stdin)", "flag": "--text-file" },
+        { "name": "voice", "type": "string", "required": false, "description": "Voice ID (default: English_expressive_narrator)", "flag": "--voice" },
+        { "name": "speed", "type": "number", "required": false, "description": "Speech speed multiplier", "flag": "--speed" },
+        { "name": "volume", "type": "number", "required": false, "description": "Volume level", "flag": "--volume" },
+        { "name": "pitch", "type": "number", "required": false, "description": "Pitch adjustment", "flag": "--pitch" },
+        { "name": "format", "type": "string", "required": false, "description": "Audio format (default: mp3)", "flag": "--format" },
+        { "name": "sample-rate", "type": "integer", "required": false, "description": "Sample rate (default: 32000)", "flag": "--sample-rate" },
+        { "name": "bitrate", "type": "integer", "required": false, "description": "Bitrate (default: 128000)", "flag": "--bitrate" },
+        { "name": "channels", "type": "integer", "required": false, "description": "Audio channels (default: 1)", "flag": "--channels" },
+        { "name": "language", "type": "string", "required": false, "description": "Language boost", "flag": "--language" },
+        { "name": "subtitles", "type": "boolean", "required": false, "description": "Include subtitle timing data", "flag": "--subtitles" },
+        { "name": "pronunciation", "type": "string", "required": false, "description": "Custom pronunciation (format: from/to)", "flag": "--pronunciation" },
+        { "name": "out", "type": "string", "required": false, "description": "Save audio to file", "flag": "--out" },
+        { "name": "stream", "type": "boolean", "required": false, "description": "Stream raw audio to stdout", "flag": "--stream" },
+        { "name": "output", "type": "string", "required": false, "description": "Output format: text, json", "flag": "--output" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "speech",
+      "action": "voices",
+      "description": "List available system voices",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["speech", "voices"],
+        "parseJson": true,
+        "missingDependencyHelp": "Run: mmx auth login --api-key sk-xxxxx"
+      },
+      "args": [
+        { "name": "language", "type": "string", "required": false, "description": "Filter voices by language (e.g. english, korean)", "flag": "--language" },
+        { "name": "output", "type": "string", "required": false, "description": "Output format: text, json", "flag": "--output" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "music",
+      "action": "generate",
+      "description": "Generate a song (music-2.6 / music-2.6-free / music-2.5+ / music-2.5)",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["music", "generate"],
+        "parseJson": false,
+        "missingDependencyHelp": "Run: mmx auth login --api-key sk-xxxxx"
+      },
+      "args": [
+        { "name": "prompt", "type": "string", "required": false, "description": "Music style description", "flag": "--prompt" },
+        { "name": "lyrics", "type": "string", "required": false, "description": "Song lyrics with structure tags", "flag": "--lyrics" },
+        { "name": "lyrics-file", "type": "string", "required": false, "description": "Read lyrics from file", "flag": "--lyrics-file" },
+        { "name": "lyrics-optimizer", "type": "boolean", "required": false, "description": "Auto-generate lyrics from prompt", "flag": "--lyrics-optimizer" },
+        { "name": "instrumental", "type": "boolean", "required": false, "description": "Generate instrumental music", "flag": "--instrumental" },
+        { "name": "vocals", "type": "string", "required": false, "description": "Vocal style description", "flag": "--vocals" },
+        { "name": "genre", "type": "string", "required": false, "description": "Music genre", "flag": "--genre" },
+        { "name": "mood", "type": "string", "required": false, "description": "Mood or emotion", "flag": "--mood" },
+        { "name": "instruments", "type": "string", "required": false, "description": "Instruments to feature", "flag": "--instruments" },
+        { "name": "tempo", "type": "string", "required": false, "description": "Tempo description (fast, slow, moderate)", "flag": "--tempo" },
+        { "name": "bpm", "type": "integer", "required": false, "description": "Exact tempo in BPM", "flag": "--bpm" },
+        { "name": "key", "type": "string", "required": false, "description": "Musical key (e.g. C major)", "flag": "--key" },
+        { "name": "model", "type": "string", "required": false, "description": "Model: music-2.6, music-2.6-free, music-2.5+, music-2.5", "flag": "--model" },
+        { "name": "output-format", "type": "string", "required": false, "description": "Return format: hex (default), url", "flag": "--output-format" },
+        { "name": "aigc-watermark", "type": "boolean", "required": false, "description": "Embed AI-generated content watermark", "flag": "--aigc-watermark" },
+        { "name": "format", "type": "string", "required": false, "description": "Audio format (default: mp3)", "flag": "--format" },
+        { "name": "sample-rate", "type": "integer", "required": false, "description": "Sample rate (default: 44100)", "flag": "--sample-rate" },
+        { "name": "bitrate", "type": "integer", "required": false, "description": "Bitrate (default: 256000)", "flag": "--bitrate" },
+        { "name": "stream", "type": "boolean", "required": false, "description": "Stream raw audio to stdout", "flag": "--stream" },
+        { "name": "out", "type": "string", "required": false, "description": "Save audio to file", "flag": "--out" },
+        { "name": "output", "type": "string", "required": false, "description": "Output format: text, json", "flag": "--output" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "music",
+      "action": "cover",
+      "description": "Generate a cover version of a song (music-cover / music-cover-free)",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["music", "cover"],
+        "parseJson": false,
+        "missingDependencyHelp": "Run: mmx auth login --api-key sk-xxxxx"
+      },
+      "args": [
+        { "name": "model", "type": "string", "required": false, "description": "Model: music-cover, music-cover-free", "flag": "--model" },
+        { "name": "prompt", "type": "string", "required": true, "description": "Target cover style description", "flag": "--prompt" },
+        { "name": "audio", "type": "string", "required": false, "description": "URL of reference audio", "flag": "--audio" },
+        { "name": "audio-file", "type": "string", "required": false, "description": "Local reference audio file", "flag": "--audio-file" },
+        { "name": "lyrics", "type": "string", "required": false, "description": "Cover lyrics", "flag": "--lyrics" },
+        { "name": "lyrics-file", "type": "string", "required": false, "description": "Read lyrics from file", "flag": "--lyrics-file" },
+        { "name": "seed", "type": "integer", "required": false, "description": "Random seed 0-1000000 for reproducible results", "flag": "--seed" },
+        { "name": "format", "type": "string", "required": false, "description": "Audio format: mp3, wav, pcm (default: mp3)", "flag": "--format" },
+        { "name": "sample-rate", "type": "integer", "required": false, "description": "Sample rate (default: 44100)", "flag": "--sample-rate" },
+        { "name": "bitrate", "type": "integer", "required": false, "description": "Bitrate (default: 256000)", "flag": "--bitrate" },
+        { "name": "channel", "type": "integer", "required": false, "description": "Channels: 1 (mono) or 2 (stereo)", "flag": "--channel" },
+        { "name": "stream", "type": "boolean", "required": false, "description": "Stream raw audio to stdout", "flag": "--stream" },
+        { "name": "out", "type": "string", "required": false, "description": "Save audio to file", "flag": "--out" },
+        { "name": "output", "type": "string", "required": false, "description": "Output format: text, json", "flag": "--output" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "search",
+      "action": "query",
+      "description": "Search the web via MiniMax",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["search", "query"],
+        "positionalArgs": ["q"],
+        "parseJson": true,
+        "missingDependencyHelp": "Run: mmx auth login --api-key sk-xxxxx"
+      },
+      "args": [
+        { "name": "q", "type": "string", "required": true, "description": "Search query string", "flag": "--q" },
+        { "name": "output", "type": "string", "required": false, "description": "Output format: text, json", "flag": "--output" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "vision",
+      "action": "describe",
+      "description": "Describe an image using MiniMax VLM",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["vision", "describe"],
+        "parseJson": true,
+        "missingDependencyHelp": "Run: mmx auth login --api-key sk-xxxxx"
+      },
+      "args": [
+        { "name": "image", "type": "string", "required": false, "description": "Local image path or URL", "flag": "--image" },
+        { "name": "file-id", "type": "string", "required": false, "description": "Pre-uploaded file ID", "flag": "--file-id" },
+        { "name": "prompt", "type": "string", "required": false, "description": "Question about the image (default: Describe the image.)", "flag": "--prompt" },
+        { "name": "output", "type": "string", "required": false, "description": "Output format: text, json", "flag": "--output" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "quota",
+      "action": "show",
+      "description": "Show usage quotas and remaining credits",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["quota"],
+        "parseJson": true,
+        "missingDependencyHelp": "Run: mmx auth login --api-key sk-xxxxx"
+      },
+      "args": []
+    },
+    {
+      "namespace": "mmx",
+      "resource": "config",
+      "action": "show",
+      "description": "Show current CLI configuration",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["config", "show"],
+        "parseJson": true,
+        "missingDependencyHelp": "Run: npm install -g mmx-cli"
+      },
+      "args": []
+    },
+    {
+      "namespace": "mmx",
+      "resource": "config",
+      "action": "set",
+      "description": "Set a configuration value",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["config", "set"],
+        "parseJson": false,
+        "missingDependencyHelp": "Run: npm install -g mmx-cli"
+      },
+      "args": [
+        { "name": "key", "type": "string", "required": true, "description": "Config key to set (e.g. region)", "flag": "--key" },
+        { "name": "value", "type": "string", "required": true, "description": "Value to set", "flag": "--value" }
+      ]
+    },
+    {
+      "namespace": "mmx",
+      "resource": "config",
+      "action": "export-schema",
+      "description": "Export configuration schema as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": ["config", "export-schema"],
+        "parseJson": true,
+        "missingDependencyHelp": "Run: npm install -g mmx-cli"
+      },
+      "args": []
+    },
+    {
+      "namespace": "mmx",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to execute any mmx CLI command directly",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mmx",
+        "baseArgs": [],
+        "passthrough": true,
+        "parseJson": false,
+        "missingDependencyHelp": "Run: npm install -g mmx-cli"
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/mmx/skills/quickstart/SKILL.md

@@ -0,0 +1,234 @@
+# mmx Usage Skill
+
+Use the mmx plugin to generate text, images, video, speech, music, and search via the MiniMax AI Platform CLI.
+
+## 1) Install and Authenticate
+
+```bash
+# Check if mmx is installed
+mmx --version
+
+# Install globally if needed
+npm install -g mmx-cli
+
+# Authenticate with API key
+mmx auth login --api-key sk-xxxxx
+
+# Or use environment variable
+export MINIMAX_API_KEY=sk-xxxxx
+```
+
+Get API key: https://platform.minimax.io/subscribe/token-plan
+
+## 2) Validate Setup
+
+```bash
+# Check authentication status
+sc mmx auth status
+
+# Show remaining quota
+sc mmx quota show
+```
+
+## 3) Text / Chat
+
+```bash
+# Simple chat
+sc mmx text chat --message "What is MiniMax?"
+
+# With system prompt and streaming
+sc mmx text chat --system "You are a coding assistant" --message "Write fizzbuzz in Go" --stream
+
+# Multi-turn conversation
+sc mmx text chat --message "user:Hi" --message "assistant:Hey!" --message "How are you?"
+
+# JSON output for parsing
+sc mmx text chat --message "Hello" --output json
+```
+
+## 4) Image Generation
+
+```bash
+# Simple image
+sc mmx image generate --prompt "A cat in a spacesuit on Mars"
+
+# Multiple images with aspect ratio
+sc mmx image generate --prompt "Mountain landscape" --n 3 --aspect-ratio 16:9
+
+# Custom dimensions (512-2048, multiple of 8)
+sc mmx image generate --prompt "Wide landscape" --width 1920 --height 1080
+
+# With prompt optimizer and watermark
+sc mmx image generate --prompt "sunset" --prompt-optimizer --aigc-watermark
+
+# Reproducible output with seed
+sc mmx image generate --prompt "A castle" --seed 42
+```
+
+## 5) Video Generation
+
+```bash
+# Simple video (async - returns immediately)
+sc mmx video generate --prompt "Ocean waves at sunset" --async --quiet
+
+# Wait for completion and download
+sc mmx video generate --prompt "A robot painting" --download robot.mp4
+
+# I2V: First frame image-to-video
+sc mmx video generate --prompt "Walk forward" --first-frame start.jpg
+
+# S2V: Subject reference for character consistency
+sc mmx video generate --prompt "A detective walking" --subject-image character.jpg
+
+# SEF: Start-end frame interpolation (requires Hailuo-02)
+sc mmx video generate --prompt "Walk forward" --first-frame start.jpg --last-frame end.jpg
+
+# Check task status
+sc mmx video task-get --task-id <task-id>
+
+# Download completed video
+sc mmx video download --file-id <file-id> --out video.mp4
+```
+
+## 6) Speech Synthesis
+
+```bash
+# Simple TTS
+sc mmx speech synthesize --text "Hello, world!" --out hello.mp3
+
+# With voice and speed control
+sc mmx speech synthesize --text "Hi" --voice English_magnetic_voiced_man --speed 1.2
+
+# List available voices
+sc mmx speech voices
+
+# Filter by language
+sc mmx speech voices --language english
+
+# Streaming audio (pipe to media player)
+sc mmx speech synthesize --text "Stream me" --stream | mpv --no-terminal -
+
+# From stdin
+echo "Breaking news" | sc mmx speech synthesize --text-file - --out news.mp3
+```
+
+## 7) Music Generation
+
+```bash
+# Generate with lyrics
+sc mmx music generate --prompt "Upbeat pop" --lyrics "[verse] La da dee, sunny day" --out song.mp3
+
+# Auto-generate lyrics from prompt
+sc mmx music generate --prompt "Indie folk, melancholic, rainy night" --lyrics-optimizer --out song.mp3
+
+# Instrumental (no vocals)
+sc mmx music generate --prompt "Cinematic orchestral" --instrumental --out bgm.mp3
+
+# Detailed music parameters
+sc 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
+
+# Cover generation from reference audio
+sc mmx music cover --prompt "Jazz, piano, warm female vocal" --audio https://example.com/song.mp3 --out cover.mp3
+
+# Local audio file
+sc mmx music cover --prompt "Indie folk" --audio-file original.mp3 --out cover.mp3
+```
+
+## 8) Vision / Image Understanding
+
+```bash
+# Describe local image
+sc mmx vision describe --image photo.jpg
+
+# From URL
+sc mmx vision describe --image https://example.com/photo.jpg --prompt "What breed is this dog?"
+
+# With specific question
+sc mmx vision describe --image photo.jpg --prompt "Extract all text from this image"
+
+# Using pre-uploaded file ID
+sc mmx vision describe --file-id file-123456789 --prompt "What is in this image?"
+```
+
+## 9) Web Search
+
+```bash
+# Simple search
+sc mmx search query --q "MiniMax AI latest news"
+
+# JSON output for parsing
+sc mmx search query --q "latest AI developments" --output json
+```
+
+## 10) Configuration
+
+```bash
+# Show current config
+sc mmx config show
+
+# Set region (global or cn)
+sc mmx config set --key region --value cn
+
+# Export config schema
+sc mmx config export-schema
+```
+
+## 11) Passthrough Mode
+
+Use the passthrough command for options not explicitly mapped:
+
+```bash
+sc mmx _ _ --help
+sc mmx _ _ text chat --message "Hello" --dry-run
+```
+
+## Common Workflows
+
+### Agent-CI Mode (non-interactive)
+```bash
+# Set env var and run non-interactively
+export MINIMAX_API_KEY=sk-xxxxx
+sc mmx text chat --message "Hello" --output json --non-interactive
+```
+
+### Streaming Responses
+```bash
+# For real-time output in terminal
+sc mmx text chat --message "Tell me a story" --stream
+
+# Stream audio
+sc mmx speech synthesize --text "Hello" --stream | mpv -
+```
+
+## Error Handling
+
+mmx uses standard exit codes:
+- 0: Success
+- 1: General error
+- 130: Interrupted (Ctrl+C)
+
+For authentication issues, re-authenticate:
+```bash
+mmx auth logout
+mmx auth login --api-key sk-xxxxx
+```
+
+## Dual Region Support
+
+MiniMax supports two regions:
+- Global: `--region global` (default) → api.minimax.io
+- CN: `--region cn` → api.minimaxi.com
+
+```bash
+# Use CN region
+sc mmx config set --key region --value cn
+
+# Or via CLI flag
+sc mmx text chat --message "Hello" --region cn
+```