AI assistant for safe, reliable productivity with code, collaboration, and integrations.
Gaugelet
About Gaugelet
Gaugelet is a native macOS utility designed to monitor ChatGPT and Codex usage allowances directly from the menu bar. It provides a clear visual representation of remaining usage across different plan windows, including weekly, five-hour, and model-specific limits. The app refreshes every five minutes to stay current with local Codex App Server data, offering a reliable alternative to OpenAI’s web interface. It supports multiple themes and integrates seamlessly with macOS 14+ on Apple silicon, including light and dark mode, launch at login, and optional native notifications. Gaugelet operates without requiring an account, analytics, or telemetry, ensuring local-first privacy by reading usage data directly from the local server. Users can set custom alerts to receive warnings before hitting critical limits, allowing for deliberate adjustments in model selection, reasoning depth, or session pacing. The tool is intended for developers and users who rely on ChatGPT or Codex and need to avoid unexpected interruptions due to exhausted allowances.
Key features
- Displays weekly, five-hour, and model-specific usage limits
- Customizable alert thresholds (e.g., 10%, 20%, 30%)
- Seven built-in themes with adaptive menu-bar icon
- Light and dark mode support
- Launch at login and optional native notifications
- Read-only access to local Codex App Server data
- Manual refresh option
- Open source and free to use
Use cases
- Monitoring ChatGPT and Codex usage for paid plans to avoid interruptions
- Adjusting model selection and reasoning depth based on remaining allowance
- Planning heavy usage sessions during periods of low consumption
Pros
- Native macOS menu-bar app with adaptive half-gauge display
- Five-minute refresh rate for up-to-date usage tracking
- Seven in-app themes including Dark Dracula, 8-Bit, and Pride
- Local-first privacy with no account, analytics, or telemetry
- Supports macOS 14+ and Apple silicon with light/dark mode
Cons
- Requires macOS 14+ and Apple silicon
- Limited to local Codex App Server data on the same machine
- No web or cross-platform support
- No built-in integration with OpenAI’s web interface
Frequently asked questions about Gaugelet
What does Gaugelet do?
Gaugelet is a native macOS menu-bar utility that displays remaining ChatGPT and Codex usage allowances in real time. It reads usage data directly from the local Codex App Server and updates every five minutes, helping users avoid unexpected interruptions by monitoring plan limits.
Who is Gaugelet designed for?
Gaugelet is designed for developers and users who rely on ChatGPT or Codex and need to track their usage allowances to prevent hitting limits unexpectedly. It is particularly useful for those who work with Apple silicon Macs running macOS 14 or later.
Does Gaugelet require an account or collect user data?
No, Gaugelet operates without requiring an account, analytics, or telemetry. It reads usage data locally from the Codex App Server and does not upload any information to external servers, ensuring local-first privacy.
How often does Gaugelet update the usage data?
Gaugelet refreshes the usage data every five minutes to stay current with the local Codex App Server. Users can also manually refresh the data as needed.
Can I customize alerts in Gaugelet?
Yes, Gaugelet allows users to set custom alerts at specific thresholds to receive warnings before hitting critical usage limits. This helps users adjust their model selection, reasoning depth, or session pacing proactively.
Is Gaugelet compatible with all macOS versions?
Gaugelet is designed for macOS 14 or newer and is built specifically for Apple silicon Macs. It supports light and dark mode, launch at login, and optional native notifications.