Skip to content

TopSoft4U/zai-usage-reset

Repository files navigation

z.ai Quota Reset Timer

Browser extension for the z.ai API subscription page.

Why

The z.ai subscription page at https://z.ai/manage-apikey/subscription shows quota usage percentages but doesn't display when the quota resets in your local timezone. You're left guessing when you can use the API again.

What it does

  • Adds a reset countdown bar inside each quota card (5h quota and monthly web search quota)
  • Shows the exact reset time in your local timezone with a color-coded progress bar (red = long wait, yellow = halfway, green = almost reset)
  • Displays the current quota multiplier badge (peak 3x / off-peak) with local peak hours on hover
  • Shows a message when the 5h quota hasn't started yet
  • Auto-switches to the "Usage" tab on page load

Compatibility

Only tested on the legacy pro plan with 5-hour and monthly reset cycles. Plans with weekly resets or different quota structures have not been tested and may not display correctly.

Install

Firefox (signed):

Install from Firefox Add-ons or download the .xpi from Releases.

Chrome:

  1. Download the .zip from Releases
  2. Extract the zip
  3. Go to chrome://extensions
  4. Enable "Developer mode"
  5. Click "Load unpacked" and select the extracted folder

Build

Tag a version and push to trigger the GitHub Actions workflow:

git tag v1.2.0
git push --tags

The workflow packages the extension files into a zip, signs the .xpi via AMO, and attaches both to a GitHub Release.

About

Since Z.AI exposes the data but simply can't make the timers visible on website - there is a simple extension.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors