@yakumoryo/minimax-plan-usage 0.1.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "@yakumoryo/minimax-plan-usage",
+  "version": "0.1.0",
+  "description": "Query quota and usage statistics for MiniMax Coding Plan service",
+  "owner": {
+    "name": "User"
+  },
+  "plugins": [
+    {
+      "name": "@yakumoryo/minimax-plan-usage",
+      "source": ".",
+      "category": "development",
+      "description": "Query quota and usage statistics for MiniMax Coding Plan service. Uses ANTHROPIC_AUTH_TOKEN and ANTHROPIC_BASE_URL from your Claude Code settings."
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "minimax-plan-usage",
+  "description": "Query MiniMax Coding Plan usage statistics",
+  "version": "0.1.0",
+  "owner": "user"
+}

package/README.md

@@ -0,0 +1,26 @@
+# MiniMax Plan Usage
+
+Query MiniMax Coding Plan usage statistics.
+
+## Usage
+
+After installation, run:
+```
+/minimax-plan-usage:usage-query
+```
+
+## How it works
+
+The plugin uses the same `ANTHROPIC_AUTH_TOKEN` and `ANTHROPIC_BASE_URL` that Claude Code uses. Based on the base URL, it determines the correct MiniMax API endpoint:
+
+- If `ANTHROPIC_BASE_URL` contains `minimax.io` → uses `https://minimax.io`
+- If `ANTHROPIC_BASE_URL` contains `minimaxi.cn` → uses `https://minimaxi.cn`
+- Otherwise → uses `https://api.minimaxi.com` (default)
+
+## Requirements
+
+- Node.js installed
+- `ANTHROPIC_AUTH_TOKEN` environment variable set
+- `ANTHROPIC_BASE_URL` environment variable set
+
+These are typically already configured in your Claude Code settings.

package/agents/usage-query-agent.md

@@ -0,0 +1,32 @@
+---
+name: usage-query-agent
+description: Query MiniMax Coding Plan usage statistics for the current account. Triggered by the /minimax-plan-usage:usage-query command.
+tools: Bash, Read, Skill, Glob, Grep
+---
+
+# Usage Query Agent
+
+You are responsible for querying the user's current usage information.
+
+## Critical constraint
+
+**Run the query exactly once.** Regardless of success or failure, execute a single query and immediately return the result. No retries, no loops.
+
+## Execution
+
+### Invoke the skill
+
+Call @minimax-plan-usage:usage-query-skill to perform the usage query.
+
+The skill will run query-usage.mjs automatically, then return the result.
+
+### Report the outcome
+
+Based on the skill output, respond to the user in Chinese.
+
+## Prohibited actions
+
+- Do not run multiple queries
+- Do not retry automatically after failure
+- Do not ask the user whether to retry
+- Do not modify files

package/commands/usage-query.md

@@ -0,0 +1,12 @@
+---
+allowed-tools: all
+description: Query MiniMax Coding Plan usage statistics
+---
+
+# Usage Query
+
+Invoke @minimax-plan-usage:usage-query-agent to retrieve the usage information for the current account.
+
+## Critical constraint
+
+**Run the query exactly once** — regardless of success or failure, execute a single query and return the result immediately.

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@yakumoryo/minimax-plan-usage",
+  "version": "0.1.0",
+  "description": "Claude Code plugin for MiniMax Coding Plan usage statistics",
+  "keywords": ["claude", "claude-code", "plugin", "minimax"],
+  "files": [
+    "commands",
+    "agents",
+    "skills",
+    ".claude-plugin"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}

package/skills/usage-query-skill/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: usage-query-skill
+description: Run the usage query script to retrieve account usage information for MiniMax Coding Plan. Only use when invoked by usage-query-agent.
+allowed-tools: Bash, Read
+---
+
+# MiniMax Usage Query Skill
+
+Execute the usage query script and return the result.
+
+## Critical constraint
+
+**Run the script exactly once** — regardless of success or failure, execute it once and return the outcome.
+
+## Execution
+
+### Run the query
+
+Use Node.js to execute the bundled script:
+
+```bash
+node skills/usage-query-skill/scripts/query-usage.mjs
+```
+
+### Return the result
+
+After execution, return the result to the caller:
+- **Success**: display the usage information in Chinese
+- **Failure**: show the error details and likely cause

package/skills/usage-query-skill/scripts/query-usage.mjs

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+
+/**
+ * MiniMax Usage Query Script
+ * Reads ANTHROPIC_BASE_URL to determine API endpoint
+ * Uses ANTHROPIC_AUTH_TOKEN as the API key
+ */
+
+import https from 'https';
+
+const baseUrl = process.env.ANTHROPIC_BASE_URL || '';
+const authToken = process.env.ANTHROPIC_AUTH_TOKEN || '';
+
+if (!authToken) {
+  console.error('Error: ANTHROPIC_AUTH_TOKEN is not set');
+  console.error('');
+  console.error('Set the environment variable and retry:');
+  console.error('  export ANTHROPIC_AUTH_TOKEN="your-token-here"');
+  process.exit(1);
+}
+
+let apiHost = 'https://api.minimaxi.com';
+
+if (baseUrl.includes('minimax.io')) {
+  apiHost = 'https://minimax.io';
+} else if (baseUrl.includes('minimaxi.cn')) {
+  apiHost = 'https://minimaxi.cn';
+} else if (baseUrl.includes('minimaxi.com')) {
+  apiHost = 'https://api.minimaxi.com';
+}
+
+const apiUrl = `${apiHost}/v1/api/openplatform/coding_plan/remains`;
+
+console.log(`MiniMax API Host: ${apiHost}`);
+console.log('');
+
+const queryUsage = () => {
+  return new Promise((resolve, reject) => {
+    const parsedUrl = new URL(apiUrl);
+    const options = {
+      hostname: parsedUrl.hostname,
+      port: 443,
+      path: parsedUrl.pathname,
+      method: 'GET',
+      headers: {
+        'Authorization': `Bearer ${authToken}`,
+        'Accept': 'application/json'
+      }
+    };
+
+    const req = https.request(options, (res) => {
+      let data = '';
+
+      res.on('data', (chunk) => {
+        data += chunk;
+      });
+
+      res.on('end', () => {
+        if (res.statusCode !== 200) {
+          if (res.statusCode === 401) {
+            return reject(new Error('认证失败，请检查 ANTHROPIC_AUTH_TOKEN 是否正确'));
+          }
+          return reject(new Error(`HTTP ${res.statusCode}: ${data}`));
+        }
+
+        try {
+          const json = JSON.parse(data);
+          if (!json.model_remains || json.model_remains.length === 0) {
+            console.log('无可用用量数据');
+            return resolve();
+          }
+
+          const m = json.model_remains[0];
+          const remaining = m.current_interval_usage_count;
+          const total = m.current_interval_total_count;
+          const used = total - remaining;
+          const percentage = Math.round((used / total) * 100);
+
+          const remainingMs = m.remains_time;
+          const hours = Math.floor(remainingMs / (1000 * 60 * 60));
+          const minutes = Math.floor((remainingMs % (1000 * 60 * 60)) / (1000 * 60));
+
+          const resetTime = new Date(m.end_time).toLocaleString('zh-CN', {
+            timeZone: 'Asia/Shanghai',
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+          });
+
+          const weeklyRemaining = m.current_weekly_usage_count;
+          const weeklyTotal = m.current_weekly_total_count;
+          const weeklyUsed = weeklyTotal - weeklyRemaining;
+          const weeklyPercentage = Math.floor((weeklyUsed / weeklyTotal) * 100);
+          const weeklyRemainingMs = m.weekly_remains_time;
+          const weeklyDays = Math.floor(weeklyRemainingMs / (1000 * 60 * 60 * 24));
+          const weeklyHours = Math.floor((weeklyRemainingMs % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
+
+          const weeklyResetTime = new Date(m.weekly_end_time).toLocaleString('zh-CN', {
+            timeZone: 'Asia/Shanghai',
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+          });
+
+          const bar = '█'.repeat(Math.floor(percentage / 10)) + '░'.repeat(10 - Math.floor(percentage / 10));
+          const timeText = hours > 0 ? `${hours}小时${minutes}分钟` : `${minutes}分钟`;
+          const weeklyBar = '█'.repeat(Math.floor(weeklyPercentage / 10)) + '░'.repeat(10 - Math.floor(weeklyPercentage / 10));
+          const weeklyTimeText = weeklyDays > 0 ? `${weeklyDays}天${weeklyHours}小时` : `${weeklyHours}小时`;
+
+          console.log('MiniMax Coding Plan 用量状态');
+          console.log('----------------------------------------');
+          console.log(`模型: ${m.model_name}`);
+          console.log(`已用(5h): ${used.toLocaleString()} / ${total.toLocaleString()}`);
+          console.log(`进度: [${bar}] ${percentage}%`);
+          console.log(`剩余(5h): ${remaining.toLocaleString()} 次`);
+          console.log(`重置: ${resetTime} (约${timeText})`);
+          console.log('----------------------------------------');
+          console.log(`周用量: ${weeklyUsed.toLocaleString()} / ${weeklyTotal.toLocaleString()}`);
+          console.log(`周进度: [${weeklyBar}] ${weeklyPercentage}%`);
+          console.log(`周重置: ${weeklyResetTime} (约${weeklyTimeText})`);
+          console.log('----------------------------------------');
+
+        } catch (e) {
+          return reject(new Error(`解析响应失败: ${e.message}`));
+        }
+        resolve();
+      });
+    });
+
+    req.on('error', (error) => {
+      if (error.code === 'ECONNABORTED') {
+        return reject(new Error('请求超时，请检查网络连接'));
+      }
+      reject(error);
+    });
+
+    req.end();
+  });
+};
+
+queryUsage().catch((error) => {
+  console.error('查询失败:', error.message);
+  process.exit(1);
+});