- JavaScript 65.9%
- Python 22.7%
- Shell 11.2%
- Makefile 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .github | ||
| .zcode/skills | ||
| docs | ||
| icons | ||
| packaging | ||
| po | ||
| scripts | ||
| tests | ||
| .gitignore | ||
| api_key_settings.py | ||
| applet.js | ||
| ATTRIBUTION.md | ||
| CHANGELOG.md | ||
| icon.png | ||
| install.sh | ||
| LICENSE | ||
| Makefile | ||
| metadata.json | ||
| notification_settings.py | ||
| README.md | ||
| SECURITY.md | ||
| settings-schema.json | ||
| uninstall.sh | ||
| usage-format.js | ||
| z_usage.py | ||
Z Usage Monitor for Cinnamon
Keep your Z.ai GLM Coding Plan beautifully in view — right in your Cinnamon panel.
| Full usage overview with the gradient plan pill | Every window with its recent consumption |
|---|---|
 |
 |
Only the Coding Plan active? The popup trims to the essentials
Same values as above — without ZCode Start Plan or Global Build quotas the popup stays sleek.
Every active quota at a glance
Hovering the panel icon summarizes every plan window with its remaining quota.
| General settings | Colors and thresholds |
|---|---|
 |
 |
Why you will love it
- Everything at a glance — 5-hour and weekly quota windows as rings in the panel and the popup, with live reset countdowns. Either panel window can be hidden when you prefer it calm.
- All your plans, stacked — the personal Coding Plan plus the ZCode Start Plan and Global Build token buckets, each with its own collapsible section.
- API-key-less by default — no setup: the applet reuses the credentials of
your signed-in ZCode app. It only performs read-only GET requests against
https://api.z.ai. - Built for real panels — horizontal and vertical panels, threshold colors, pinned header and action footer, and a scrollable popup that never lets content escape.
- Sticky chrome — title, quota rings and the action buttons stay visible while the details scroll beneath them.
Installation
./install.sh
Then enable Z Usage Monitor via System Settings → Applets and add it to a panel. Requires Python 3.10+ and Cinnamon 5.8 or newer.
Credentials: nothing to configure if the ZCode app is signed in — the
applet picks up its Coding Plan API key automatically. Optional overrides:
the Z.ai API key setting, the ZAI_API_KEY environment variable, or the
file ~/.config/cinnamon-z-usage/api-key.
The popup
| Zone | What you get |
|---|---|
| Header (pinned) | Title, the gradient plan pill, the last-update stamp and the 5h / 7d quota rings |
| Usage limits | Coding Plan 5h/7d plus ZCode Start Plan and Global Build sections, each with reset countdowns |
| Credits | Remaining credits plus the "Used:" line with 24h/12h/4h/1h consumption tokens |
| Recent consumption | Per-plan 1h/4h/12h/Today summaries and the 24-hour activity charts |
| Footer (pinned) | Z.ai Chat, ZCode, Refresh now, Usage dashboard |
Links
- Development, architecture and the fork/backport guide: docs/README.md
- Sibling applet: cinnamon-chatgpt-usage (ChatGPT Work & Codex)
Credits
Built with love by Claudiu & ZCode as part of
OSS Singularity. Forked from
cinnamon-chatgpt-usage
by Claudiu & Codex. All bundled icons are original OSS Singularity artwork
(GPL-3.0-or-later) except the bundled symbolic action icons from
Ubuntu Yaru; see icons/ATTRIBUTION.md.
Licensed under GPL-3.0-or-later.