Hmbown/MiniMax-CLI

Última atividade de origem registrada: 13 de janeiro de 2026 às 02:03

Catálogo do SkillsMP atualizado: 9 de novembro de 2026 às 14:22

skills coletadas: 19

Estrelas no GitHub: 28
Forks no GitHub: 8

Instalar com um assistente de IA

Copie este prompt para o assistente de IA que você usa.

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

README do repositório

Arquivo de origem do README: README.md

Ler o README original

Expandir README completo

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

Carregando o README do repositório…

Skills neste repositório

Produtores e diretores Artistas de efeitos especiais e animadores Diretores musicais e compositores Técnicos em engenharia de som

12 categorias ocupacionais · 100% classificado

skill

ocupação

descrição

atualizado

ad-commercial-kit

Produtores e diretoresEscritores e autores

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