How raycalrui/codexmeter works
CodexMeter is a native macOS menu-bar app for viewing Codex quota and token activity. Its main workflow launches the local Codex App Server, reads account and rate-limit data, records account-separated history, and presents refreshed status in the menu bar and popover. Users can also browse and export history, customize the interface, and manage updates. The README documents the App Server protocol and these product capabilities; source excerpts are partial, so some internal links remain unverified.
Main entry points: CodexUsageService.swift Codex service · CodexMeterApp.swift App lifecycle · UsageHistoryModel.swift History model · AppSettingsView.swift Settings interface
Components 26
Quota Runtime
- App lifecycle
CodexMeter/CodexMeterApp.swift - Codex service
CodexMeter/CodexUsageService.swift - Quota models
CodexMeter/Core/QuotaModels.swift - Reset credits
CodexMeter/Core/RateLimitResetCredits.swift
App Interface
- Quota popover
CodexMeter/ContentView.swift - Menu bar indicator
CodexMeter/MenuBarProgressView.swift - History window
CodexMeter/UsageHistoryView.swift - History charts
CodexMeter/HistoryChartComponents.swift
Usage History
- History model
CodexMeter/UsageHistoryModel.swift - History store
CodexMeter/Core/UsageHistoryStore.swift - History models
CodexMeter/Core/HistoryModels.swift - Account identity
CodexMeter/Core/HistoryAccountIdentity.swift - History backup
CodexMeter/Core/HistoryBackup.swift - Backup controls
CodexMeter/HistoryBackupView.swift
Settings and Support
- App settings
CodexMeter/AppSettings.swift - Settings interface
CodexMeter/AppSettingsView.swift - Popover customization
CodexMeter/PopoverCustomizationView.swift - Developer options
CodexMeter/DeveloperOptionsView.swift - Notifications
CodexMeter/NotificationManager.swift - Update checker
CodexMeter/UpdateChecker.swift - About window
CodexMeter/AboutView.swift - Appearance model
CodexMeter/Core/MenuBarAppearance.swift - Popover configuration
CodexMeter/Core/PopoverContentConfiguration.swift
Other components
- Mac user
- Codex CLI
- Codex App Server
Connections 36
- Mac user → App lifecycle: launches
README.md - App lifecycle → Codex service: starts
CodexMeter/CodexMeterApp.swift - App lifecycle → Quota popover: presents
CodexMeter/CodexMeterApp.swift - App lifecycle → History window: presents
CodexMeter/CodexMeterApp.swift - App lifecycle → History model: creates
CodexMeter/CodexMeterApp.swift - App lifecycle → App settings: creates
CodexMeter/CodexMeterApp.swift - App lifecycle → Update checker: creates
CodexMeter/CodexMeterApp.swift - Codex service → Codex CLI: launches
README.md - Codex CLI → Codex App Server: starts
README.md - Codex service → Codex App Server: exchanges JSON-RPC
README.md - Codex service → History model: records snapshots
CodexMeter/CodexUsageService.swift - Codex service → Notifications: evaluates alerts
CodexMeter/CodexUsageService.swift - Codex service → Quota models: uses quota values
- Codex service → Reset credits: reads reset data
- Quota popover → Codex service: shows usage
CodexMeter/ContentView.swift - Quota popover → Menu bar indicator: renders indicator
- Quota popover → History model: shows history
CodexMeter/ContentView.swift - History window → History model: loads history
CodexMeter/UsageHistoryView.swift - History window → Codex service: shows current usage
CodexMeter/UsageHistoryView.swift - History window → History charts: renders charts
- History model → History store: queries and records
CodexMeter/UsageHistoryModel.swift - History store → Account identity: uses account keys
CodexMeter/Core/UsageHistoryStore.swift - History store → History backup: imports and exports
CodexMeter/Core/UsageHistoryStore.swift - History model → History models: exposes history data
- Backup controls → History model: manages history
CodexMeter/HistoryBackupView.swift - Settings interface → App settings: edits preferences
CodexMeter/AppSettingsView.swift - Settings interface → Popover customization: opens customization
CodexMeter/AppSettingsView.swift - Settings interface → Developer options: opens developer options
CodexMeter/AppSettingsView.swift - Settings interface → Backup controls: opens backup controls
CodexMeter/AppSettingsView.swift - Settings interface → About window: opens about
CodexMeter/AppSettingsView.swift - Popover customization → App settings: updates preferences
CodexMeter/PopoverCustomizationView.swift - Popover customization → Popover configuration: configures sections
CodexMeter/PopoverCustomizationView.swift - Developer options → App settings: updates appearance
CodexMeter/DeveloperOptionsView.swift - Menu bar indicator → Appearance model: renders styles
CodexMeter/MenuBarProgressView.swift - About window → Update checker: shows update status
CodexMeter/AboutView.swift - Update checker → Mac user: offers signed updates
README.md