feat(quota): show remaining percentage with decimals (also ask: can the API return decimals?)

Open
#249 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
55/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
typescript
Domain
api, cli

Research direction

Start with the mmx quota command and trace how current_weekly_remaining_percent and current_interval_remaining_percent from GET /v1/token_plan/remains are formatted. Confirm the current output and add coverage for at least two decimal places; the API precision request must be routed to the service owner or support channel because this repository does not own that endpoint.

Written by the indexing model from the issue text.

Description

Summary

The Token Plan quota endpoint returns current_weekly_remaining_percent and current_interval_remaining_percent as integers, which loses a lot of useful precision at the low end (e.g. 2.8% left is rendered as 3%). I'd like:

  1. The API to return decimals (ideally with several fractional digits).
  2. The CLI (mmx quota) to render at least 2 decimal places, regardless of (1).

API

Endpoint:

GET https://www.minimax.io/v1/token_plan/remains
Authorization: Bearer ${MINIMAX_API_KEY}
Content-Type: application/json

Today:

{
  "current_weekly_remaining_percent": 97,
  "current_interval_remaining_percent": 85
}

What I'd like to see (any of these would be a strict improvement):

{
  "current_weekly_remaining_percent": 97.85,
  "current_interval_remaining_percent": 85.31
}

…or, ideally, full precision:

{
  "current_weekly_remaining_percent": 97.8532,
  "current_interval_remaining_percent": 85.3117385248
}
Note: this repo doesn't own the API

I know MiniMax-AI/cli is the CLI, not the API service. If a maintainer can either:

  • forward this request to whoever owns /v1/token_plan/remains, or
  • point me at the right repo / contact / support channel for API changes,

…I'd really appreciate it. If the answer is "file it at ", I'll happily move the conversation there.

CLI

Even before (1) lands, the CLI can stop rounding. Today:

╭──────────────────────────────────────────────────────────────────────────────╮
│ MINIMAX  TokenPlan Quota                       Week: 2026-08-31 — 2026-09-07 │
├────────────────────────────────────────────────────────────┬─────────────────┤
│ general  Left             85%   Wk left             97%    │ 5h Reset 36m    │
├────────────────────────────────────────────────────────────┼─────────────────┤
│ video    Left            3 / 3  Wk left            21 / 21 │ 1d Reset 4h 36m │
╰────────────────────────────────────────────────────────────┴─────────────────╯

Expected:

╭──────────────────────────────────────────────────────────────────────────────╮
│ MINIMAX  TokenPlan Quota                       Week: 2026-08-31 — 2026-09-07 │
├────────────────────────────────────────────────────────────┬─────────────────┤
│ general  Left            85.58% Wk left            97.01%  │  5h Reset 36m   │
├────────────────────────────────────────────────────────────┼─────────────────┤
│ video    Left            3 / 3  Wk left            21 / 21 │ 1d Reset 4h 36m │
╰────────────────────────────────────────────────────────────┴─────────────────╯

A --no-color / --no-decimals flag for users who prefer the old look would be a nice extra, but the default should change.

Thanks! 🙏

Dominant language
TypeScript
Stars
2.2k
Forks
181
Avg merge
9h 4m
Merged PRs (30d)
13

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from MiniMax-AI/cli

All issues in MiniMax-AI/cli

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.