See your Codex account limits from the macOS menu bar.

Download latest release · Install with Homebrew

• Zero setup: Picks up local Codex sessions automatically.
• 5h usage in your menu bar: Check your active account's 5h usage frictionless.
• Track all at once: See usage and reset info across accounts and workspace in one panel.
• Smart planing: Accounts are ranked by remaining headroom so you can pick the right account to burn.
• Privacy first: Comux supports custom display names and stores account metadata locally in ~/.comux.

Install with Homebrew:

brew install --cask Hsiii/tap/comux

Or download from GitHub Releases.

Requirements:

• macOS 14 Sonoma or newer
• A local Codex install with at least one signed-in account

• Keep Codex signed in locally; Comux reads existing Codex session state.
• Open Comux from Applications and use the menu bar item to review accounts and workspaces.
• Optional: rename accounts in Comux when you want private or easier-to-scan labels.

Comux uses your existing local Codex session state to refresh usage. Account metadata and custom display names are stored locally in ~/.comux; Comux does not require a separate hosted account.

If Comux does not show an account, open Codex and confirm that account is signed in locally, then reopen the Comux menu. If Homebrew installs an older version, run brew update and then brew upgrade --cask Hsiii/tap/comux.

swift run comux

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
brew install xcodegen
make dmg

Local builds are ad-hoc signed unless COMUX_CODE_SIGN_IDENTITY is set to a Developer ID Application identity.

make build

make dmg