MiniMax Usage Monitor for macOS

A native macOS menu-bar app that displays your MiniMax Token Plan usage in real-time: 5-hour and weekly limits, with usage-based color coding and optional low-quota notifications.

⬇️ Download

Grab the latest release: MiniMaxUsage.dmg

Features

• 🟢🟠🔴 Color-coded status bar — green / orange / red based on remaining quota
• 📊 5h + Weekly progress bars — matches the official MiniMax console format
• 🔄 Auto-refresh every 60s (configurable)
• 🔔 Notifications — alerts you when 5h window is about to reset with unused quota
• 🌍 i18n — English & Simplified Chinese, switchable in Settings
• 🪶 Lightweight — single 314KB binary, no external dependencies
• 🔓 Open source — Apache 2.0, audit the code yourself

Installation

Option 1: Download DMG (easiest)

1. Download MiniMaxUsage.dmg from the latest release
2. Open the DMG and drag MiniMaxUsage.app to your Applications folder
3. Launch from Spotlight / Launchpad

Option 2: Build from source

Requires: macOS 14+ with Command Line Tools (xcode-select --install). No Xcode required.

git clone https://github.com/<owner>/MiniMaxUsage.git
cd MiniMaxUsage
./Scripts/build.sh          # builds MiniMaxUsage.app
open MiniMaxUsage.app

Setup

1. Click the menu-bar icon → ⚙️ Settings...
2. Get an API key at platform.minimaxi.com/user-center/basic-information/interface-key
3. Paste the sk-cp-... Subscription Key
4. Save

The app starts monitoring immediately.

Usage

Click on menu bar	Result
Click the M 57% 3h49m text	Opens dropdown with full details
Right-click	Menu: refresh / settings / quit

Status bar format

M {remaining%} {time_left}
  ^             ^
  |             └─ "3h49m" / "45m" / "4d12h" / "soon"
  └─ 5h remaining % (color-coded by used %)

5h used	Color
< 50%	🟢 green
50-80%	🟠 orange
≥ 80%	🔴 red

Architecture

Single-file Swift app, no external dependencies. Uses:

• AppKit — NSStatusItem, NSMenu, NSWindow
• UserNotifications — local notification API
• Foundation — networking, file I/O

Directory structure

MiniMaxUsage/
├── Sources/MiniMaxUsage/      # All source code (single file)
│   ├── MiniMaxUsage.swift     # App entry, state, UI, networking
│   └── Info.plist             # LSUIElement, AppIcon path
├── Resources/                 # Static assets
│   ├── AppIcon.icns           # macOS icon bundle
│   └── logo.png               # Source PNG
├── Scripts/                   # Build / install / uninstall
│   ├── build.sh               # Compile + create .app bundle
│   ├── install.sh             # Copy to /Applications + clear quarantine
│   └── uninstall.sh           # Remove app + data + LaunchAgent
├── LaunchAgents/              # Login item plist
│   └── com.minimax.usagemonitor.plist
├── .github/workflows/         # CI: build + security scan
├── .gitignore
├── LICENSE                    # Apache 2.0
├── README.md
└── SECURITY.md                # API key handling policy

How the API works

Endpoint	Method	Auth	Cost
https://api.minimaxi.com/v1/token_plan/remains	GET	Bearer	Free (no quota consumed)
https://api.minimax.io/v1/token_plan/remains	GET	Bearer	Free (no quota consumed)

The 5h and weekly usage are returned in JSON:

{
  "model_remains": [{
    "model_name": "MiniMax-M3",
    "current_interval_remaining_percent": 74,
    "current_interval_status": 1,
    "current_weekly_remaining_percent": 80,
    "current_weekly_status": 1,
    "weekly_boost_permille": 1500
  }]
}

Note: The field named current_*_usage_count is misleadingly named — it actually represents remaining count, not used count. We compute real "used %" using the more reliable current_*_remaining_percent field, applying the weekly_boost_permille multiplier for the weekly view to match the official console.

Privacy

• All data stays on your Mac
• Only outgoing request: GET /v1/token_plan/remains to MiniMax API
• No telemetry, no analytics, no third-party SDKs
• API key stored in ~/Library/Application Support/MiniMaxUsage/key with 0600 permissions

See SECURITY.md for full details.

License

Apache License 2.0. See LICENSE.

Credits

• Original concept & UI design based on harriewang/ai-usage-monitor (Apache 2.0)
• API field definitions referenced from MiniMax-AI/cli (TypeScript)
• MiniMax logo © MiniMax (used with attribution)

Contributing

PRs welcome! Before submitting:

./Scripts/build.sh    # ensure it compiles
git grep -E "sk-(cp|api)-"   # ensure no API keys