humanerd-drew/opencode-drewgent/minimax-usage
Claude Code and agent skill by humanerd-drew/opencode-drewgent
- community
Checking that the SKILL.md file is still in the repository.
Install
npx vskill@latest install humanerd-drew/opencode-drewgent/minimax-usageSKILL.md
The same SKILL.md was published earlier as humanerd-drew/opencode-drewgent/minimax-usage.
name: minimax-usage description: Check MiniMax Token Plan usage, current 5h interval, and weekly remaining — terminal-friendly output (no browser/console). Use when the user asks about "Token Plan 남은거", "minimax 사용량", "리셋까지 얼마", "주간 한도", or wants a quick status check without opening platform.minimax.io/console. title: MiniMax Token Plan — Terminal Usage Check domain: devops space: growth type: workflow tags: [minimax, token-plan, api, usage, {{AGENT_NAME_LOWER}}] created: 2026-06-02 updated: 2026-06-02 links:
- "[[@memory/growth/INTEGRATION_PROTOCOL]]"
- "[[@identity/SELF_MODEL]]"
- "[[@identity/brain/rules]]"---
MiniMax Token Plan — Terminal Usage Check
Skip platform.minimax.io/console — query the Token Plan API directly from the terminal.
1. API Endpoint (discovered 2026-06-02)
Why GET, not POST: trial showed POST returns 404 page not found. GET returns JSON.
Auth source: MINIMAX_API_KEY from ~/.{{AGENT_NAME_LOWER}}/.env (also exported in ~/.zshrc).
2. Response Schema (important: percentages, not absolute counts)
Window math: 5h interval = (end_time - start_time) / 1000 / 3600 = 5. Weekly = 7 days. Timestamps are in user's local TZ (already in KST when shown via datetime.fromtimestamp().astimezone()).
3. Ready-Made Script (created 2026-06-02)
~/.{{AGENT_NAME_LOWER}}/scripts/minimax_usage.py (7.1KB, no external deps, stdlib only)
Output format:
4. Shell alias (user must add manually)
~/.zshrc is write-protected from mcp_patch. User adds these 2 lines themselves:
5. Pitfalls
P1: Absolute token counts not exposed
The fields current_interval_usage_count / current_weekly_usage_count are always 0 in the response. MiniMax exposes only percentages of the window remaining, not absolute token consumption. For absolute counts, the user has to go to platform.minimax.io/console — there's no programmatic alternative for this endpoint. Don't promise the user token counts if they ask.
P2: POST returns 404, use GET
First instinct for /coding_plan/remains is to POST (since it's an action-like endpoint name). The endpoint is actually GET-only. Trial found this in 1 attempt.
P3: ~/.zshrc is write-protected
mcp_patch on ~/.zshrc returns Write denied: ... is a protected system/credential file. Don't try to add aliases via patch — instruct the user to add them in their next shell session. The .env API key is fine to read from the script, but adding shell config requires user action.
P4: tcsetattr: Inappropriate ioctl for device warning
Bash warning when piping minimax_usage.py --watch through timeout/non-TTY. Comes from Python's TTY detection in the watch loop. Harmless in real terminal use. The --watch mode also clears the screen on each refresh, which can be janky in non-TTY contexts.
P5: Video bucket reports "unlimited"
The model_name: "video" entry typically shows current_interval_status: 3 (unlimited) and current_weekly_status: 3. The user's main concern is general (text models). Don't get confused by video bucket's 100% remaining — it's not a separate quota, just labeled as unlimited for billing purposes.
P6: Window times are local TZ
start_time / end_time are ms-epoch UTC, but datetime.fromtimestamp(...).astimezone() renders them in the user's local TZ (KST in {{AGENT_NAME}}'s case). Don't double-convert or you'll show wrong times.
6. Future Extensions (suggested, not implemented)
- Statusline integration:
mm: 51% | 5d16hnext to the prompt. Touches {{AGENT_NAME}} identity layer → confirm with user before implementing. - Cron alert: When
current_interval_remaining_percent < 20, send Discord notification. Add as separate cron job + skill. - Multi-account support: If user has multiple MiniMax keys, allow
mm-usage --key <name>to switch. Currently the script reads only one fixed path.
7. Related
- [[@memory/growth/INTEGRATION_PROTOCOL]] — {{AGENT_NAME}} 3-file integration protocol
- [[@identity/SELF_MODEL]] — {{AGENT_NAME}} identity (for statusline extension)
~/.{{AGENT_NAME_LOWER}}/scripts/minimax_usage.py— the implementation~/.{{AGENT_NAME_LOWER}}/.env— API key source- MiniMax console: https://platform.minimax.io/console (for absolute counts, fallback only)
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/devops/minimax-usage/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/humanerd-drew/opencode-drewgent/minimax-usage)