Headroom：免费开源的 Mac 菜单栏 Codex 用量与重置时间追踪工具

I'm building Headroom, a free open-source macOS menu-bar app for checking Codex remaining usage limits and reset times. It also has a separate Claude Code tracker.

For Codex, it launches the installed official Codex CLI's app-server and reads account/rateLimits/read using your existing ChatGPT-subscription sign-in. That quota read doesn't send a model request, and you don't need to keep a Codex window open.

The Codex menu-bar label uses the most-used quota window. The UI keeps unknown readings unknown, and after a reset countdown expires it waits for a fresh reading rather than assuming the allowance has refilled. Readings are advisory and can become stale or unavailable.

This is an early source-build project, free under the MIT licence. Setup requires macOS 14+, Xcode/macOS SDK, Swift 6, Python 3 and command-line developer tools; the Claude feed also uses jq. The development app is ad hoc signed and unnotarized. The README documents setup and current limitations.

Source: https://github.com/jimkang12345-coder/Headroom

I'm a solo builder learning in public, and I'd welcome bug reports, critique and fixes. I plan to explore other OSes, possibly iOS, while keeping Headroom free.