CodexBar 是一个 macOS 菜单栏应用,用于查看本机 Codex 账号状态、额度、Token 用量、详细统计信息
Swift appkitcodexcodex-clideveloper-toolsmacosmacos-appmenu-bar-appopenai-codexproductivityswiftswiftuiusage-tracker
CodexBar
View Codex status in your macOS menu bar
简体中文 | English
Features | Installation | Privacy | Runtime architecture | Protocol
CodexBar is a macOS menu bar app for viewing your Codex account, rate limits, token usage, and live task status.
Features
Account and rate limits
- View your account, plan, credits, and the remaining percentage and reset time for each rate-limit window
- Show your preferred allowance directly in the menu bar
- View banked resets and their expiry dates, and have CodexBar use them automatically before they expire
Task progress
- See each task's project, model, reasoning effort, duration, and token usage
- Track execution states, tasks awaiting a response, task progress, and recent events
- Use Task Center to view concurrent tasks and tasks that recently completed, failed, or were interrupted
Usage statistics
- Track total usage, daily peaks, usage streaks, and your longest task duration
- View daily token usage and activity statistics in a heatmap
- Combine usage records across Macs through iCloud
Notifications and task glow
- Receive alerts for task completions, tasks awaiting a response, allowance changes, and protection events
- Choose notification types, sounds, and task haptic feedback
- See status changes in the task glow at the top of your displays, and customize its appearance
Keep awake
- Keep your Mac awake while tasks run, then allow normal sleep when they finish
- Choose whether to keep your Mac awake while tasks await a response and whether to keep the display on
- Set a keep-awake time limit and enable low-battery and stalled task protection
Installation
Homebrew
brew install --cask bob-zebedy/tap/codexbar@5
DMG
Download the latest version from GitHub Releases, then drag CodexBar into Applications.
Requirements
- macOS 15.0 or later
- Codex CLI version
0.162.0or later installed and signed in with OpenAI - Sign in to an available iCloud account on your Mac to sync across devices
Privacy
CodexBar processes raw activity events and live tasks on your Mac. When you enable cross-device sync, it uploads daily activity summaries and token usage records to your private iCloud database.
Feedback
Report bugs, request features, or ask questions through GitHub Issues.