pi-minimax-cli
v1.1.1
Published
A pi coding agent extension that wraps the MiniMax mmx CLI as callable tools with self-evolving architecture
Maintainers
ramankarkiReadme
pi-minimax-cli
A pi extension that integrates MiniMax's mmx CLI as callable tools.
Note: This package consumes maximum of 5k tokens of the context window when loaded, as it registers all mmx CLI commands as tools in the pi agent.
Purpose
This package demonstrates a self-evolving architecture where the extension can rebuild itself when MiniMax releases a new mmx CLI version. Instead of manually updating the extension code, you simply approve the rebuild and pi reconstructs it from scratch.
How It Works
┌─────────────────────────────────────────────────────────────────────┐
│ Self-Evolution Loop │
└─────────────────────────────────────────────────────────────────────┘
User runs mmx tool
│
▼
┌─────────────┐ ┌─────────────┐ ┌───────────────┐
│ Check mmx │───►│ Version │───►│ If mismatch │
│ version │ │ compare │ │ → warn user │
└─────────────┘ └─────────────┘ └───────────────┘
│ │
┌──────┘ └──────┐
│ User says "yes" │
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│ Run skill that │ │ Continue with │
│ triggers prompt │ │ current version │
└────────┬────────┘ └─────────────────┘
│
▼
┌─────────────────┐
│ Prompt template │
│ scrapes mmx -h │
│ and rebuilds │
│ extension.ts │
└─────────────────┘The Components
| Component | File | Role |
| ------------- | --------------------------------------- | ------------------------------------- |
| Extension | extensions/pi-minimax-cli.ts | Wraps mmx commands as pi tools |
| Prompt | prompts/build-pi-minimax-cli.md | Instructions to rebuild the extension |
| Skill | skills/update-pi-minimax-cli/SKILL.md | Triggers the rebuild workflow |
Project Structure
pi-minimax-cli/
├── extensions/
│ └── pi-minimax-cli.ts # Tool wrappers (auto-regenerated)
├── prompts/
│ └── build-pi-minimax-cli.md # Rebuild instructions
├── skills/
│ └── update-pi-minimax-cli/
│ └── SKILL.md # Trigger for rebuild
└── AGENTS.md # Agent contextGenerated Tools
After the prompt rebuilds the extension, you get access to these tool categories:
🖼️ Image Generation
| Tool | Description |
| -------------------- | ------------------------------------------ |
| mmx_image_generate | Generate images (image-01 / image-01-live) |
// Example: Generate an image
mmx_image_generate({
prompt: 'A cozy coffee shop interior with warm lighting',
aspect_ratio: '16:9',
n: 2,
});
// Returns: [{ url: "..." }, { url: "..." }]🎬 Video Generation
| Tool | Description |
| -------------------- | -------------------------- |
| mmx_video_generate | Text-to-video (Hailuo-2.3) |
| mmx_video_task_get | Poll video task status |
| mmx_video_download | Download completed video |
// Example: Generate a video
mmx_video_generate({
prompt: 'A drone shot flying over misty mountains at sunrise',
model: 'MiniMax-Hailuo-2.3',
download: './output/drone-shot.mp4',
});
// Returns: { task_id: "v_abc123", status: "processing" }🎵 Music Generation
| Tool | Description |
| -------------------- | -------------------------- |
| mmx_music_generate | Generate songs (music-2.6) |
| mmx_music_cover | Generate cover versions |
// Example: Generate background music
mmx_music_generate({
prompt: 'Ambient lo-fi hip hop for study sessions',
mood: 'chill and relaxed',
instruments: 'piano, lo-fi beats',
out: './output/study-beats.mp3',
});🗣️ Speech Synthesis
| Tool | Description |
| ----------------------- | ------------------------------ |
| mmx_speech_synthesize | Text-to-speech (speech-2.8-hd) |
| mmx_speech_voices | List available voices |
// Example: Synthesize narration
mmx_speech_synthesize({
text: 'Welcome to the future of AI creativity',
voice: 'English_expressive_narrator',
speed: 1.0,
out: './output/narration.mp3',
});🔍 Web Search
| Tool | Description |
| ------------------ | -------------------------- |
| mmx_search_query | Search the web via MiniMax |
👁️ Vision
| Tool | Description |
| --------------------- | ------------------------- |
| mmx_vision_describe | Describe images using VLM |
// Example: Analyze an image
mmx_vision_describe({
image: './photos/product.png',
prompt: 'Describe this product photo for an e-commerce listing',
});
// Returns: "A sleek wireless headphone on a white background..."Example: Using the Tools Inside pi Agent
Here's what a typical conversation looks like when using these tools:
User Prompt
Generate a short video of a cat playing piano in a jazz bar, then
create some moody background music for it, and add narration saying
"Ladies and gentlemen, witness the future of music."pi Agent Response
Generating video...
mmx_video_generate→{ task_id: "v_k9x2m" }
Creating background music...
mmx_music_generate→ Saved to./jazz-cat-music.mp3
Polling video status...
mmx_video_task_get→ status: "processing"
Video ready! Downloading...
mmx_video_download→ Saved to./jazz-cat.mp4
Adding narration...
mmx_speech_synthesize→ Saved to./narration.mp3
Done! Created three files:
./jazz-cat.mp4(12 second video)./jazz-cat-music.mp3(30 second ambient jazz)./narration.mp3(dramatic voiceover)
User Prompt
Analyze the attached product photo and write a short e-commerce
description, then generate a promotional image in a different style.pi Agent Response
Analyzing image...
mmx_vision_describe→ "A minimalist ceramic vase with... Sage green glaze, matte finish, approximately 25cm tall. Set against a concrete background with soft natural lighting."
Writing e-commerce description...
Generated: "Handcrafted sage green ceramic vase with a matte glaze finish. Perfect for minimalists seeking to add a touch of nature to their space. Each piece is unique with natural color variations."
Generating promotional image...
mmx_image_generate→ Saved to./promo-vase.jpg
Done! Analyzed your photo and created a promotional variant.