{"_id":"@alfonsodg/minimax-coding-helper","name":"@alfonsodg/minimax-coding-helper","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@alfonsodg/minimax-coding-helper","publishConfig":{"access":"public"},"version":"0.1.0","description":"MiniMax M2.1 Coding Plan Helper for managing multi coding tools","main":"dist/index.js","bin":{"minimax-helper":"dist/cli.js","mhelper":"dist/cli.js"},"type":"module","engines":{"node":">=18.0.0"},"scripts":{"build":"tsc","dev":"tsx watch src/cli.ts","start":"node dist/cli.js","clean":"rm -rf dist","prepublishOnly":"pnpm run clean && pnpm run build"},"keywords":["cli","coding","minimax","m2.1","ai"],"author":{"name":"Alfonso de la Guarda"},"license":"Apache-2.0","dependencies":{"chalk":"^5.3.0","commander":"^12.1.0","inquirer":"^9.2.12","js-yaml":"^4.1.0","ora":"^8.0.1"},"devDependencies":{"@types/inquirer":"^9.0.7","@types/js-yaml":"^4.0.9","@types/node":"^22.10.2","tsx":"^4.20.6","typescript":"^5.7.2"},"_id":"@alfonsodg/minimax-coding-helper@0.1.0","gitHead":"a9b0deedbddf35496b761418892dc71da39334d2","types":"./dist/index.d.ts","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-7L1+DoiMsjHjZCdXlA/KvMDj7A4ySxIO41p6PLp+1ZSl5Pt2FMAKNtQg1FB5CwvEVrnBVj61bvF26PrVtncacA==","shasum":"1ef269901c502fb9726ab71cbc87085a0102129f","tarball":"https://registry.npmjs.org/@alfonsodg/minimax-coding-helper/-/minimax-coding-helper-0.1.0.tgz","fileCount":17,"unpackedSize":76900,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDk1WRgwdVg2ARrBBTpKtOiql+3dVA6fnA4iAAHxphGbwIgUcDg6s2O9GLi92XEkRAB2liGUDCaie85IvhTTvAic2I="}]},"_npmUser":{"name":"alfonsodg","email":"alfonsodg@gmail.com"},"directories":{},"maintainers":[{"name":"alfonsodg","email":"alfonsodg@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/minimax-coding-helper_0.1.0_1766930208817_0.4491538370982642"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-28T13:56:48.707Z","0.1.0":"2025-12-28T13:56:48.955Z","modified":"2025-12-28T13:56:49.272Z"},"maintainers":[{"name":"alfonsodg","email":"alfonsodg@gmail.com"}],"description":"MiniMax M2.1 Coding Plan Helper for managing multi coding tools","keywords":["cli","coding","minimax","m2.1","ai"],"author":{"name":"Alfonso de la Guarda"},"license":"Apache-2.0","readme":"# MiniMax M2.1 Coding Helper\n\nA CLI tool to configure [MiniMax M2.1](https://platform.minimax.io/) model in AI coding tools. Similar to `@z_ai/coding-helper` but for MiniMax.\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                 MiniMax M2.1 Coding Helper                  │\n├─────────────────────────────────────────────────────────────┤\n│                                                             │\n│   ┌─────────────┐      ┌──────────────────────────────┐    │\n│   │   mhelper   │─────▶│  Configure Coding Tools      │    │\n│   └─────────────┘      │  • Claude Code, Cursor       │    │\n│         │              │  • Cline, Kilo Code, Roo     │    │\n│         │              │  • Droid, OpenCode, Crush    │    │\n│         │              │  • Zed, Neovim, Aider...     │    │\n│         │              └──────────────────────────────┘    │\n│         │                                                   │\n│         │              ┌──────────────────────────────┐    │\n│         └─────────────▶│  Configure MCP Servers       │    │\n│                        │  • web_search                │    │\n│                        │  • understand_image          │    │\n│                        │  For 14+ AI agents           │    │\n│                        └──────────────────────────────┘    │\n│                                                             │\n└─────────────────────────────────────────────────────────────┘\n```\n\n## Features\n\n- 🔧 **Auto-Configuration** - Automatically writes config files for supported tools\n- 🗑️ **Uninstall** - Remove MiniMax configuration from any tool\n- 🌐 **MCP Server** - Configure `web_search` & `understand_image` tools for 14+ agents\n- 🩺 **Health Check** - See what's configured at a glance\n- 🌍 **Multi-language** - English, Español, 中文\n- 📍 **Multi-region** - Global (`api.minimax.io`) and China (`api.minimaxi.com`)\n\n## Installation\n\n```bash\n# npm\nnpm install -g minimax-coding-helper\n\n# pnpm\npnpm add -g minimax-coding-helper\n\n# From source\ngit clone https://github.com/user/minimax-coding-helper\ncd minimax-coding-helper\npnpm install && pnpm build\nnpm link\n```\n\n## Usage\n\n```bash\n# Interactive menu (recommended)\nmhelper\n\n# First-time setup wizard\nmhelper init\n\n# Check configuration status\nmhelper doctor\n```\n\n### Interactive Menu\n\n```\n? What would you like to do?\n❯ 🔧 Configure coding tool\n  🌐 Configure MCP server\n  🗑️  Remove configuration\n  ─────────────\n  🌍 Change language\n  📍 Change region\n  🔑 Change API key\n  🩺 Health check\n  ─────────────\n  ❌ Exit\n```\n\n## Supported Tools\n\n### Auto-Configuration (writes config files)\n\n| Tool | Config File | Status |\n|------|-------------|--------|\n| Claude Code | `~/.claude/settings.json` | ✅ |\n| Droid | `~/.factory/config.json` | ✅ |\n| OpenCode | `~/.config/opencode/opencode.json` | ✅ |\n| Continue | `~/.continue/config.json` | ✅ |\n| Crush | `~/.config/crush/crush.json` | ✅ |\n| Codex CLI | `~/.codex/config.toml` | ✅ |\n| Zed | `~/.config/zed/settings.json` | ✅ |\n\n### Manual Configuration (shows instructions)\n\n| Tool | Notes |\n|------|-------|\n| Cursor | GUI configuration |\n| Cline | VS Code extension (M2.1 coming soon, use M2) |\n| Kilo Code | VS Code extension |\n| Roo Code | VS Code extension |\n| TRAE | GUI configuration |\n| Windsurf | GUI configuration |\n| Grok CLI | Environment variables (not recommended) |\n| Aider | Environment variables |\n| Neovim | avante.nvim / codecompanion.nvim |\n\n### MCP Server Configuration\n\nConfigure MiniMax MCP tools (`web_search`, `understand_image`) for multiple agents:\n\n| Agent | Config File | Format |\n|-------|-------------|--------|\n| Claude Code | `~/.claude.json` | mcpServers |\n| Cursor | `~/.cursor/mcp.json` | mcpServers |\n| Kiro | `~/.kiro/settings/mcp.json` | mcpServers |\n| Amazon Q | `~/.aws/amazonq/mcp.json` | mcpServers |\n| Droid | `~/.factory/mcp.json` | mcpServers |\n| Grok | `~/.grok/mcp.json` | mcpServers |\n| Copilot CLI | `~/.copilot/mcp-config.json` | mcpServers |\n| Kilocode | `~/.kilocode/mcp.json` | mcpServers |\n| Gemini | `~/.gemini/antigravity/mcp_config.json` | mcpServers |\n| Warp | `~/.config/warp/mcp.json` | mcpServers |\n| Claude Desktop | `~/.config/Claude/claude_desktop_config.json` | mcpServers |\n| Zed | `~/.config/zed/settings.json` | context_servers |\n| VS Code | `~/.config/Code/User/settings.json` | chat.mcp.servers |\n| Crush | `~/.config/crush/crush.json` | mcp (type: stdio) |\n\n## Configuration\n\nConfig stored at `~/.minimax-helper/config.yaml`:\n\n```yaml\nlang: en_US          # en_US, es_ES, zh_CN\nregion: global       # global or china\napi_key: <your-key>\n```\n\n## API Endpoints\n\n| Region | Anthropic API | OpenAI API |\n|--------|---------------|------------|\n| Global | `https://api.minimax.io/anthropic` | `https://api.minimax.io/v1` |\n| China | `https://api.minimaxi.com/anthropic` | `https://api.minimaxi.com/v1` |\n\n## Examples\n\n### Configure Claude Code with MiniMax M2.1\n\n```bash\nmhelper\n# Select: Configure coding tool → Claude Code → Install/Configure\n```\n\nResult in `~/.claude/settings.json`:\n```json\n{\n  \"env\": {\n    \"ANTHROPIC_BASE_URL\": \"https://api.minimax.io/anthropic\",\n    \"ANTHROPIC_AUTH_TOKEN\": \"<your-api-key>\",\n    \"ANTHROPIC_MODEL\": \"MiniMax-M2.1\"\n  }\n}\n```\n\n### Configure MCP for multiple agents\n\n```bash\nmhelper\n# Select: Configure MCP server → (select agents)\n```\n\nResult adds MiniMax MCP server with `web_search` and `understand_image` tools.\n\n### Check what's configured\n\n```bash\nmhelper doctor\n```\n\nOutput:\n```\n🩺 Checking configuration...\n\n✓ API Key: Configured\n✓ Region: global\n✓ Language: en_US\n\n📊 Configured tools:\n\n  ✓ Claude Code\n  ✓ Droid\n  ✓ MCP (Claude Code)\n  ✓ MCP (Cursor)\n\n  Base URL (Anthropic): https://api.minimax.io/anthropic\n  Base URL (OpenAI): https://api.minimax.io/v1\n```\n\n## Prerequisites\n\n### For MCP tools\n\n```bash\n# Install uvx (required for MCP server)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n### Get API Key\n\n1. Visit [MiniMax Platform](https://platform.minimax.io/user-center/basic-information/interface-key)\n2. Subscribe to [Coding Plan](https://platform.minimax.io/subscribe/coding-plan) (optional, for better rates)\n3. Create API key\n4. Run `mhelper init`\n\n## Documentation\n\n- [MiniMax M2.1 for AI Coding Tools](https://platform.minimax.io/docs/guides/text-ai-coding-tools)\n- [MiniMax MCP Guide](https://platform.minimax.io/docs/guides/coding-plan-mcp-guide)\n- [MiniMax Tool Use & Interleaved Thinking](https://platform.minimax.io/docs/guides/text-m2-function-call)\n\n## Author\n\n**Alfonso de la Guarda**  \n📧 alfonso@gmail.com\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-62a9b835e135673709dcb440d7887be7"}