English | 简体中文
A lightweight native macOS menu bar utility that displays the weekly quota remaining and reset time for the current Codex account.
This is an independent community project. It is not affiliated with, endorsed by, or sponsored by OpenAI.
- Shows the remaining weekly quota directly in the menu bar
- Refreshes every 60 seconds, with manual refresh support
- Automatically adapts to light, dark, and fullscreen menu bar backgrounds
- Uses a warning symbol for low quota instead of relying on fixed colors
- Shows the used percentage and next reset time
- Optional launch at login
- Native multi-resolution macOS app icon
- Does not read, copy, or upload
~/.codex/auth.json; quota data is retrieved through the local Codex CLIapp-server
- Download
Codex-Weekly-macOS.zipfrom the latest release. - Extract the archive.
- Move
Codex Weekly.appto/Applications. - Launch the app. It runs in the menu bar and does not appear in the Dock.
- If macOS blocks the non-notarized community build, right-click the app in Finder and choose Open.
Codex Desktop or Codex CLI must already be installed and signed in.
./build-app.sh
.build/release/CodexWeekly --probeBuild artifacts are written to dist/. Building requires macOS 13+ and Xcode/Swift 6.
The app starts the local Codex CLI with app-server --stdio, calls
account/rateLimits/read, and displays the quota window whose duration is
10,080 minutes (one week).
- Does not directly read
~/.codex/auth.json - Does not copy or upload Codex tokens
- Contains no analytics, telemetry, or third-party network requests
- All quota access is handled locally by the Codex CLI
The Codex CLI app-server is experimental, so future protocol changes may require updates.
swift test
swift run CodexWeekly --probeProject structure:
CodexQuotaClient.swift: Codex app-server communicationQuotaSnapshot.swift: weekly quota parsing and window selectionAppDelegate.swift: menu bar UI, refresh scheduling, and launch at loginQuotaParserTests.swift: protocol response parsing tests