How desmondlee95700/aiusage works
AIUsage is a native macOS menu-bar app for viewing local account and quota data from Antigravity, ChatGPT/Codex, and Claude. The principal workflow starts at the menu-bar controller, refreshes provider discovery and quota state through QuotaService, then presents the selected providers’ usage in a popover and status item. The README also documents provider filtering, account/plan details, reset windows, and Liquid Glass styling. Arrows reflect the excerpts, source index references, or README; unsampled provider-protocol details are represented only where documented.
Main entry points: QuotaService.swift Quota Coordinator · MainUsageView.swift Usage Popover · StatusBarController.swift Menu Bar Controller · CodexDiscovery.swift Codex Discovery
Components 26
App Entry
- App Startup
Sources/main.swift - Menu Bar Controller
Sources/MenuBar/StatusBarController.swift
Discovery & Quotas
- Quota Coordinator
Sources/Services/QuotaService.swift - Antigravity Discovery
Sources/Services/ProcessDiscovery.swift - Codex Discovery
Sources/Services/CodexDiscovery.swift - Claude Discovery
Sources/Services/ClaudeDiscovery.swift - Codex Quota Client
Sources/Services/CodexService.swift - Claude Quota Client
Sources/Services/ClaudeService.swift - Antigravity Quota Client
Sources/Services/QuotaService.swift - Quota Data Models
Sources/Models/QuotaModels.swift
Usage Presentation
- Usage Popover
Sources/Views/MainUsageView.swift - Provider Filter
Sources/Views/ProviderFocusSubmenuView.swift - ChatGPT Quota Card
Sources/Views/ChatGPTQuotaCardView.swift - Claude Quota Card
Sources/Views/ClaudeQuotaCardView.swift - Antigravity Quota Card
Sources/Views/QuotaCardView.swift - Credits Card
Sources/Views/CreditsCardView.swift - Plan & Account Card
Sources/Views/PlanCardView.swift - Progress Rings
Sources/Views/CircularProgressView.swift - Provider Icons
Sources/Views/AppIconHelper.swift - Version Display
Sources/Models/AppVersion.swift
Appearance
- Glass Preference Observer
Sources/Services/LiquidGlassObserver.swift - Liquid Glass Styling
Sources/Views/LiquidGlass.swift
Other components
- Mac User
- Antigravity Runtime
- ChatGPT Runtime
- Claude Desktop
Connections 29
- Mac User → Menu Bar Controller: opens menu
README.md - App Startup → Menu Bar Controller: starts
Sources/main.swift - Menu Bar Controller → Quota Coordinator: refreshes state
Sources/MenuBar/StatusBarController.swift - Menu Bar Controller → Usage Popover: shows popover
Sources/MenuBar/StatusBarController.swift - Menu Bar Controller → Provider Icons: renders status
Sources/MenuBar/StatusBarController.swift - Menu Bar Controller → Version Display: shows version
Sources/MenuBar/StatusBarController.swift - Quota Coordinator → Antigravity Discovery: discovers runtime
Sources/Services/QuotaService.swift - Quota Coordinator → Codex Discovery: discovers runtime
Sources/Services/QuotaService.swift - Quota Coordinator → Claude Discovery: discovers runtime
Sources/Services/QuotaService.swift - Quota Coordinator → Codex Quota Client: fetches quotas
Sources/Services/QuotaService.swift - Quota Coordinator → Claude Quota Client: fetches quotas
Sources/Services/QuotaService.swift - Quota Coordinator → Antigravity Quota Client: refreshes quotas
Sources/Services/QuotaService.swift - Antigravity Discovery → Antigravity Runtime: probes locally
- Codex Discovery → ChatGPT Runtime: finds runtime
Sources/Services/CodexDiscovery.swift - Claude Discovery → Claude Desktop: discovers app
Sources/Services/ClaudeDiscovery.swift - Codex Quota Client → Codex Discovery: resolves runtime
Sources/Services/CodexService.swift - Quota Coordinator → Quota Data Models: holds quota state
- Usage Popover → Quota Coordinator: reads usage state
Sources/Views/MainUsageView.swift - Usage Popover → Provider Filter: shows filter
Sources/Views/MainUsageView.swift - Provider Filter → Quota Coordinator: changes selection
Sources/Views/ProviderFocusSubmenuView.swift - Usage Popover → ChatGPT Quota Card: renders provider
Sources/Views/MainUsageView.swift - Usage Popover → Claude Quota Card: renders provider
Sources/Views/MainUsageView.swift - Usage Popover → Antigravity Quota Card: renders provider
Sources/Views/MainUsageView.swift - Usage Popover → Plan & Account Card: renders account details
Sources/Views/MainUsageView.swift - ChatGPT Quota Card → Progress Rings: shows limits
Sources/Views/ChatGPTQuotaCardView.swift - Claude Quota Card → Progress Rings: shows limits
Sources/Views/ClaudeQuotaCardView.swift - Antigravity Quota Card → Progress Rings: shows limits
Sources/Views/QuotaCardView.swift - Usage Popover → Glass Preference Observer: reads intensity
Sources/Views/MainUsageView.swift - Glass Preference Observer → Liquid Glass Styling: informs styling
Sources/Views/LiquidGlass.swift