Hmbown/MiniMax-CLI

Latest recorded source activity: January 13, 2026 at 02:03

SkillsMP catalog refreshed: October 29, 2026 at 18:30

skills collected: 19

GitHub stars: 28
GitHub forks: 8

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/Hmbown/MiniMax-CLI.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# MiniMax CLI [![CI](https://github.com/Hmbown/MiniMax-CLI/actions/workflows/ci.yml/badge.svg)](https://github.com/Hmbown/MiniMax-CLI/actions/workflows/ci.yml) [![crates.io](https://img.shields.io/crates/v/minimax-cli)](https://crates.io/crates/minimax-cli) Unofficial terminal UI (TUI) + CLI for the [MiniMax platform](https://platform.minimax.io): chat with **MiniMax-M2.5**, run an approval-gated tool-using agent, and generate media (images, video, music, TTS). Not affiliated with MiniMax Inc. ## Quickstart 1. Get an API key from https://platform.minimax.io 2. Install and run: ```bash cargo install minimax-cli --locked export MINIMAX_API_KEY="YOUR_MINIMAX_API_KEY" minimax ``` Or download a prebuilt binary from [GitHub Releases](https://github.com/Hmbown/MiniMax-CLI/releases). 3. Press `F1` or run `/help` for the in-app command list 4. If anything looks off, run `minimax doctor` ## Install ### From crates.io (recommended) ```bash cargo install minimax-cli --locked ``` ### Build from source ```bash git clone https://github.com/Hmbown/MiniMax-CLI.git cd MiniMax-CLI cargo build --release ./target/release/minimax --help ``` ### Direct download Download a prebuilt binary from https://github.com/Hmbown/MiniMax-CLI/releases and put it on your `PATH` as `minimax`. ## Configuration On first run, the TUI can prompt for your API key and save it to `~/.minimax/config.toml`. You can also create the file manually: ```toml # ~/.minimax/config.toml api_key = "YOUR_MINIMAX_API_KEY" # must be non-empty default_text_model = "MiniMax-M2.5" # optional allow_shell = false # optional max_subagents = 3 # optional (1-5) ``` Useful environment variables: - `MINIMAX_API_KEY` (overrides `api_key`) - `MINIMAX_BASE_URL` (default: `https://api.minimax.io`; China users may use `https://api.minimaxi.com`) - `MINIMAX_PROFILE` (selects `[profiles.<name>]` from the config; errors if missing) - `MINIMAX_CONFIG_PATH` (override config path) - `MINIMAX_MCP_CONFIG`, `MINIMAX_SKILLS_DIR`, `MINIMAX_NOTES_PATH`, `MINIMAX_MEMORY_PATH`, `MINIMAX_ALLOW_SHELL`, `MINIMAX_MAX_SUBAGENTS` - `MINIMAX_AUTO_COMPACT`, `MINIMAX_COMPACTION_TOKEN_THRESHOLD`, `MINIMAX_COMPACTION_MESSAGE_THRESHOLD`, `MINIMAX_COMPACTION_KEEP_RECENT`, `MINIMAX_COMPACT_PROMPT`, `MINIMAX_AUTO_COMPACT_TOKEN_LIMIT` See `config.example.toml` and `docs/CONFIGURATION.md` for a full reference. ## Modes In the TUI, press `Tab` to cycle modes: **Normal → Plan → Agent → YOLO → RLM → Duo → Normal**. - **Normal**: chat; asks before file writes, shell, or paid tools - **Plan**: design-first prompting; same approvals as Normal - **Agent**: multi-step tool use; asks before shell or paid tools - **YOLO**: enables shell + trust + auto-approves all tools (dangerous) - **RLM**: externalized context + REPL helpers; auto-approves tools (best for large files) - **Duo**: player-coach autocoding with iterative validation (based on g3 paper) Approval behavior is mode-dependent, but you can also override it at runtime with `/set approval_mode auto|suggest|never`. ## Tools MiniMax CLI exposes tools to the model: file read/write/patching, shell execution, web search, sub-agents, and MiniMax media APIs. - **Workspace boundary**: file tools are restricted to `--workspace` unless you enable `/trust` (YOLO enables trust automatically). - **Approvals**: the TUI requests approval depending on mode and tool category (file writes, shell, paid media). - **Web search**: `web_search` uses DuckDuckGo HTML results and is auto-approved. - **Runtime parity tools**: `web.run`, `multi_tool_use.parallel`, `request_user_input`, `weather`, `finance`, `sports`, `time`, and `calculator` are available in agent-capable modes. - **Background shell jobs**: `exec_shell` supports `background=true`; inspect with `exec_shell_list` and clean old tasks with `exec_shell_clean` (or use `/jobs` in the TUI). Metadata persists at `<workspace>/.minimax/state/background_jobs.json`. On startup/session sync/`/reload`, jobs are restored; any previously `running` job is reclassified as `orphaned` with a reason because process handles cannot be reattached across restart. - **Sub-agent registry**: sub-agent metadata persists at `<workspace>/.minimax/state/subagents.json`. On startup/session sync/`/reload`, registry entries are restored; any previously `running` sub-agent is reclassified as `failed` with reason `interrupted: previous MiniMax session ended before completion`. - **Runtime restore status**: the UI emits `Restored runtime state (...)` summaries during startup/session sync/`/reload`, plus `Runtime state warning: ...` when persisted state files are unreadable/corrupt (soft-fail, no crash). - **Media tools**: image/video/music/TTS tools make paid API calls and write real files. - **Skills**: reusable workflows stored as `SKILL.md` directories (default: `~/.minimax/skills`). Use `/skills` and `/skill <name>` (this repo includes examples under `skills/`). - **MCP**: load external tool servers via `~/.minimax/mcp.json` (supports `servers` and `mcpServers`). MCP tools currently execute without TUI approval prompts, so only enable servers you trust. See `docs/MCP.md`. ### Runtime API Server Run a local runtime HTTP/SSE server: ```bash minimax serve --http --host 127.0.0.1 --port 7878 --workers 2 ``` Thread/task state persists under `~/.minimax/tasks` (override with `MINIMAX_TASKS_DIR`). Core endpoints: - `GET /health` - `GET /v1/sessions` - `POST /v1/stream` - `GET/POST /v1/threads` - `GET /v1/threads/{id}` - `POST /v1/threads/{id}/resume` - `POST /v1/threads/{id}/fork` - `POST /v1/threads/{id}/turns` - `POST /v1/threads/{id}/turns/{turn_id}/steer` - `POST /v1/threads/{id}/turns/{turn_id}/interrupt` - `POST /v1/threads/{id}/compact` - `GET /v1/threads/{id}/events` - `GET/POST /v1/tasks` - `GET /v1/tasks/{id}` - `POST /v1/tasks/{id}/cancel` ## RLM RLM mode is designed for “too big for context” tasks: large files, whole-doc sweeps, and big pasted blocks. - Auto-switch triggers: “largest file”, explicit “RLM”, large file requests, and large pastes. - In **RLM mode**, `/load @path` loads a file into the external context store (outside RLM mode, `/load` loads a saved chat JSON). - Use `/repl` to enter expression mode (e.g. `search(\"pattern\")`, `lines(1, 80)`). - Power tools: `rlm_load`, `rlm_exec`, `rlm_status`, `rlm_query`. `rlm_query` can be expensive: prefer batching and check `/status` if you're doing lots of sub-queries. ## Duo Mode Duo mode implements the player-coach autocoding paradigm for iterative development with built-in validation: - **Player**: implements requirements (builder role) - **Coach**: validates implementation against requirements (critic role) - Tools: `duo_init`, `duo_player`, `duo_coach`, `duo_advance`, `duo_status` Workflow: `init → player → coach → advance → (repeat until approved)` ## Examples ```bash minimax # Interactive TUI minimax -p "Write a haiku" # One-shot prompt (prints and exits) minimax doctor # Diagnose config + API key minimax sessions --limit 50 # List sessions (~/.minimax/sessions) minimax --resume latest # Resume most recent session minimax --resume <id-prefix> # Resume by ID/prefix minimax --workspace /path/to/project minimax --yolo # Start in YOLO mode (dangerous) minimax init # Generate a starter AGENTS.md ``` Shell completions: ```bash minimax completions zsh > _minimax minimax completions bash > minimax.bash minimax completions fish > minimax.fish ``` Run the paid media smoke test (writes real files and spends credits): ```bash minimax --workspace . smoke-media --confirm ``` ## Troubleshooting - **No API key**: set `MINIMAX_API_KEY` or run `minimax` and complete onboarding - **Config not found**: check `~/.minimax/config.toml` (or `MINIMAX_CONFIG_PATH`) - **Wrong region / base URL**: set `MINIMAX_BASE_URL` to `https://api.minimaxi.com` (China) - **Session issues**: run `minimax sessions` and try `minimax --resume latest` - **MCP tools missing**: validate `~/.minimax/mcp.json` (or `MINIMAX_MCP_CONFIG`) and restart ## Documentation - `docs/README.md` - `docs/CONFIGURATION.md` - `docs/MCP.md` - `docs/RUNTIME_API.md` - `docs/ARCHITECTURE.md` - `CONTRIBUTING.md` ## Development ```bash cargo build cargo test cargo fmt cargo clippy ``` ## License MIT --- MiniMax is a trademark of MiniMax Inc. This is an unofficial project.

Loading the repository README…

Skills in this repository

Producers & Directors Music Directors & Composers Special Effects Artists & Animators Sound Engineering Technicians

12 occupation categories · 100% classified

skill

occupation

description

updated

ad-commercial-kit

Producers & DirectorsWriters & Authors

Create professional commercials with hook narration, product demonstration, music, and call-to-action.

2026-01-13

educational-course-kit

Instructional CoordinatorsAdult Basic Education, Adult Secondary Education, & English as a Second Language Instructors

Generate complete micro-courses with lesson scripts, slide images, narration audio, and preview videos.

2026-01-13

game-asset-generator

Special Effects Artists & AnimatorsGraphic Designers

Generate game assets: character concepts, item icons, ambient music, and preview trailers.

2026-01-13

interactive-story-kit

Special Effects Artists & AnimatorsMusic Directors & Composers

Create branching audio stories with distinct character voices and atmospheric music that shifts with narrative mood.

2026-01-13

language-learning-kit

Teachers & Instructors, All Other

Generate vocabulary flashcards and pronunciation guides with native audio and cultural context images.

2026-01-13

meditation-wellness-kit

Music Directors & Composers

Generate calming audio-visual experiences for meditation, sleep, and relaxation.

2026-01-13

music-video-generator

Producers & DirectorsMusic Directors & Composers+1

Create synchronized music and matching video from a unified creative prompt.

2026-01-13

product-photography-kit

Photographers

Transform product photos into e-commerce ready images with backgrounds, lifestyle contexts, and marketing variations.

2026-01-13

social-media-kit

Special Effects Artists & Animators

Generate vertical TikTok/Reels videos with captions, trending music, and engaging hooks.

2026-01-13

trailer-teaser-generator

Producers & Directors

Create cinematic trailers with voiceover, tension-building music, and dramatic visual sequences.

2026-01-13

voice-podcast-kit

Sound Engineering Technicians

Create multi-host podcast episodes with cloned voices, intro music, and transitions.

2026-01-13

voiceover-studio

News Analysts, Reporters, & Journalists

Design custom voices from text prompts and produce professional narration with voice design previews.

2026-01-13

audiobook-studio

Sound Engineering Technicians

Produce a full multi-chapter audiobook with consistent narration and exportable files.

2026-01-12

audiobook-workshop

Sound Engineering Technicians

Turn long text or a file into an audiobook using async TTS, voice selection, and file tools.

2026-01-12

music-promo-pack

Music Directors & Composers

Generate a short music clip with cover art and an optional voice tag.

2026-01-12

photo-learning

Software Developers

Recognize a photo and narrate a kid-friendly explanation using image understanding + TTS.

2026-01-12

short-drama-kit

Producers & Directors

Generate a short script, character voices, and an optional teaser for a mini drama.

2026-01-12

storybook-lesson

Software Developers

Create a kid-friendly learning card with an illustration and narrated audio.

2026-01-12

video-studio

Producers & Directors

Build a custom short video pack with script, narration, music, and visuals.

2026-01-12

Showing 19 of 19 collected skills.