Codex Accounts

A macOS menu bar app that tracks Codex CLI usage across multiple OpenAI accounts.

What it does

The Codex CLI has two rate limits: a rolling 5-hour window and a weekly window. When you hit either one, requests start failing. If you juggle multiple OpenAI accounts, it's hard to know at a glance which one still has quota left.

Codex Accounts shows the lowest remaining percentage across all your accounts directly in the menu bar. Click the icon to open a popover with a card for each account. Each card has both usage meters with time-to-reset countdowns, credit balance if your plan has one, and the plan type.

The app watches ~/.codex/auth.json. When you run codex auth to switch accounts, it picks up the new account automatically. Tokens refresh in the background before they expire.

Requirements

• macOS 15 or later
• Codex CLI installed: npm i -g @openai/codex
• At least one account authenticated via codex auth

Build

1. Clone this repo
2. Open CodexAccounts/CodexAccounts.xcodeproj in Xcode 26 or later
3. In the Signing & Capabilities tab, set your Apple Developer team
4. Build and run

No third-party dependencies.

GitHub Release DMG (automatic)

This repo is configured to build and attach a .dmg automatically in two ways:

1. Every push to main updates a rolling pre-release tag named latest with CodexAccounts-latest.dmg
2. Every published GitHub Release uploads a versioned DMG like CodexAccounts-v1.0.0.dmg

One-time setup

1. Push this repo (including .github/workflows/release-dmg.yml and scripts/build-dmg.sh) to GitHub.
2. In GitHub, open Settings → Actions → General and keep workflow permissions set to allow read/write for contents (or leave default and rely on workflow-level contents: write).

Every release

1. Push a tag (example: v1.0.0):

git tag v1.0.0
git push origin v1.0.0

2. In GitHub, create and publish a Release from that tag.
3. The workflow runs on macOS, builds the app, creates CodexAccounts-v1.0.0.dmg, and uploads it to that Release.

Install the newest build after any push

After you push to main, Actions updates the latest pre-release automatically.

Download from:

• https://github.com/<your-username>/<your-repo>/releases/tag/latest

Look for CodexAccounts-latest.dmg.

One-command release (with gh)

If you have GitHub CLI installed and authenticated, you can publish in one command:

./scripts/publish-release.sh v1.0.0

This will:

1. Create/push the git tag
2. Create/publish the GitHub Release
3. Trigger Actions to build+attach the DMG automatically

If you want to attach a locally built DMG immediately (in addition to CI), use:

./scripts/publish-release.sh v1.0.0 --attach-now

You can also build a DMG locally with:

./scripts/build-dmg.sh v1.0.0

Output is written to dist/.

Adding accounts

The app detects your current account from ~/.codex/auth.json on launch. To add another, click "Add Account" in the popover, then in a terminal run:

codex logout
codex auth

The app watches the auth file and adds the new account automatically.

Privacy

The only network requests are to chatgpt.com/backend-api/wham/usage to fetch usage numbers and auth.openai.com/oauth/token to refresh tokens when they expire. No analytics, no telemetry.

Account data (including tokens) is stored locally in ~/Library/Application Support/CodexAccounts/accounts.json. Nothing else leaves your machine.

License

MIT