QuotaRing
FREE & OPEN SOURCE · macOS 14+ · v2.0

QuotaRing

Battery-style macOS menu bar app and desktop widgets for your AI quotas and API balances.

Formerly Copilot Quota — evolved in v2.0 into a multi-AI monitor while keeping the minimalist macOS battery-widget aesthetic. Track GitHub Copilot, DeepSeek, OpenRouter, and GLM Coding Plan at a glance.

$brew tap addozhang/quotaring https://github.com/addozhang/QuotaRing && brew install --cask quotaring
QuotaRing Menu Bar App and Desktop Widgets

Supported AI Subscriptions & API Balances

◎

GitHub Copilot

Connect cleanly via GitHub OAuth Device Flow to track monthly premium requests and reset countdown. Upgrading from Copilot Quota v1.x? Your existing Keychain credentials and preferences migrate automatically.

◈

DeepSeek

Track prepaid CNY / USD balances with top-up and grant breakdowns via API Key. Set an optional budget cap with low-balance ring color warnings.

◇

OpenRouter

Monitor prepaid USD credits via API Key with an optional budget cap, turning API spend into a clean battery-style progress ring on your desktop.

◐

GLM Coding Plan

Supports both BigModel (open.bigmodel.cn) and Z.ai (api.z.ai) via API Key, tracking 5-hour and weekly rolling windows side-by-side.

01

Small & Medium Desktop Widgets with Native Battery Aesthetics

Follows macOS Sonoma & Sequoia WidgetKit guidelines. Use the Small widget for a single ring (right-click Edit Widget to pick any provider), or the Medium widget to display 2–4 rings side-by-side like macOS Batteries.

QuotaRing Small and Medium Widgets in Light and Dark Mode
02

Lightweight Menu Bar Companion with Adaptive Height

Lives quietly in your menu bar (icon-only by default, Dock icon hidden). Click to open a dynamically sized popover, tap + to add providers, pick refresh intervals, or sync manually. Automatically follows system language (English & 简体中文).

QuotaRing Menu Bar Popover
03

Host-Only Keychain Credentials & Pure-Renderer Widgets

All OAuth tokens and API keys are stored per-account in the macOS Keychain (app.solocraft.quotaring) and never leave your Mac. The sandboxed WidgetKit extension has zero network and zero Keychain access, reading only sanitized display snapshots. Signed with Developer ID and notarized by Apple.

HOST-ONLY KEYCHAIN ARCHITECTURE app.solocraft.quotaring
Menu Bar Host
Keychain Secrets · Concurrent Sync
→
WidgetKit
Zero Network · Sanitized Snapshots
✓ Developer ID Signed & Apple Notarized · Direct HTTPS Only

System Requirements & Specifications

Operating System macOS 14.0+ (Sonoma / Sequoia)
Architecture Universal (Apple Silicon & Intel)
Tech Stack Swift · SwiftUI · WidgetKit
Credential Storage macOS Keychain (Host-Only)
Code Signing Developer ID · Apple Notarized
Distribution Open Source · DMG & Homebrew