English | 简体中文 | 日本語 | 한국어 | Русский

Godex

Simple macOS menu bar utility for tracking Codex token usage progress against a daily goal.

Features

• Read local Codex token_count events from ~/.codex/sessions/**/*.jsonl
• Track daily progress with a configurable start-of-day boundary
• Configure the automatic refresh frequency, with a default of 5 minutes
• Show progress in the macOS status bar icon
• Review usage by hour, day, week, and month
• Toggle Dock icon visibility
• Toggle launch at login
• Support English, Simplified Chinese, Japanese, Korean, and Russian UI, with English fallback for unsupported languages

Notes

• The log parsing logic is adapted from codex-usage.
• Debug builds default to direct file access. Release builds default to sandbox folder access with security-scoped bookmarks.
• Launch at login uses SMAppService.mainApp, which works best once the app is run as a normal signed .app bundle from Xcode or a built archive.
• You can override the code path at runtime with GODEX_ACCESS_MODE=direct or GODEX_ACCESS_MODE=sandbox.

Open

Open Godex.xcodeproj in Xcode.