Quota Radar

Language: English | 简体中文

Quota Radar is a macOS menu bar app for monitoring search API balances and LLM coding-plan quotas. It is designed like a compact monitoring utility: the menu bar shows the smallest actionable signal, the popover triages risk, and the main window explains key quota, recent change, timing, refresh status, and actions.

Current version: v0.4.0.

Screenshots

The main window shows provider-level Key Quota, Credential Pool, Critical Time, Status, and actions. Recent change stays under Key Quota; expanded accounts keep plan, quota windows, critical time, and refresh status separated. Screenshots are captured from the running app, with credentials masked by Quota Radar.

The menu bar popover is a compact attention feed: a one-line risk summary, a short watchlist, and a risk-ranked list of the few quota signals that need action.

Features

• Risk-first menu bar popover for low quota, expiring plans, failed checks, and recent activity, with row clicks jumping to the matching provider and account in the main window.
• Main quota overview organized by Provider, Key Quota, Credential Pool, Critical Time, Status, and actions.
• Multiple accounts per provider, with account-level plan, remaining quota, reset/expiry timing, and update time.
• Recent quota changes stay beside the quota they describe; Last Updated stays a refresh-status signal instead of repeating consumption deltas.
• API-key and web-login authorization credentials, including companion API keys for providers whose quota checks require web login.
• Local secret storage in ~/Library/Application Support/QuotaRadar/secrets.json with 0600 permissions.
• .env, cURL, and ~/.claude/settings.json import paths for supported providers.
• Configurable automatic refresh, quota-consuming refresh protection, proxy settings, color scheme, launch at login, and GitHub Release update checks in standard builds.
• White-label / no-updater build mode for distribution packages that should not embed the upstream GitHub Release URL.

Quick Start

./install.sh --bundle-only --rebuild
open 'build/Quota Radar.app'

Install into /Applications:

./install.sh

Run behavior tests:

bash Tests/run_behavior_tests.sh

For the full setup flow, see Quickstart.

Cross-Platform Tauri Track

The Tauri app in apps/desktop-tauri is a cross-platform migration track, not the stable release track and not a drop-in replacement for the Swift macOS app yet. It must first catch up with the current Swift mainline features, quota-history semantics, provider calibration rules, and the native compact monitoring style before it can be treated as a preview candidate.

Useful checks while working on that track:

bash scripts/check_tauri_sources.sh
cd apps/desktop-tauri
pnpm install
pnpm test -- --run
pnpm typecheck
cargo test --manifest-path src-tauri/Cargo.toml
pnpm tauri build --no-bundle --ci

The current Tauri gap list is tracked in Desktop Tauri Parity Checklist.

White-Label Build

Use this mode when you need a DMG without automatic update checks and without embedded upstream GitHub Release URLs:

scripts/package_dmg.sh --rebuild --white-label
open build/QuotaRadar-WhiteLabel.dmg

The white-label flag is compile-time, not a runtime preference. It hides update-check UI, disables launch-time update checks, and removes the hardcoded GitHub Release endpoints from the app bundle.

Supported Providers

AI Search providers include Tavily, Brave Search, SerpAPI, Serper, Exa, Bocha, AnySearch, Querit, and WeChat Search.

LLM / plan providers include Claude Subscription, Anthropic Credits, Codex Subscription, Kimi, DeepSeek, XFYun Spark Coding Plan, Volcengine Coding Plan, OpenCode Go, Aliyun Coding Plan, and Tencent Cloud Coding Plan.

Provider credential types, quota fields, reset windows, plan expiry, parser notes, and hidden extension stubs are documented in Providers.

Documentation

• Quickstart
• Providers
• Provider Calibration
• Release QA
• Roadmap
• Desktop Tauri Parity Checklist
• 中文 README

Unsigned DMG And Gatekeeper

Local, self-use, or no-fee unsigned DMG:

scripts/package_dmg.sh --rebuild
open build/QuotaRadar.dmg

Manual GitHub Release upload:

gh release create v0.4.0 build/QuotaRadar.dmg \
  --title "Quota Radar v0.4.0" \
  --notes "Codex reset-credit expiry support, a cleaner account-row reset action group, provider calibration updates, web-login credential hardening, and unsigned DMG for trusted users."

Unsigned DMGs do not require an Apple Developer Program account, but macOS Gatekeeper may block downloaded copies. Install only if you trust the source repository and release. If macOS says the app is damaged or cannot be opened:

xattr -dr com.apple.quarantine '/Applications/Quota Radar.app'
open '/Applications/Quota Radar.app'

For broader distribution, use Developer ID signing and Apple notarization.