Codex-Tools

Lightweight, native Swift macOS menu bar app for switching between multiple Codex auth sessions.

Features

• Fast menu bar account switching
• Manage accounts (add/import/rename/delete)
• Usage refresh with "next best" recommendation
• Prompted switching that closes Codex sessions when needed
• Automatic Codex app relaunch after confirmed account switches

Install

Homebrew

brew tap VincentBurke/tap
brew install codex-tools

Run once:

codex-tools

Start at login (recommended):

brew services start codex-tools

Disable launch-at-login:

brew services stop codex-tools

When started via brew services:

• Quit codex-tools exits the app and keeps it stopped for the current session.
• If the process crashes, launchd restarts it.

Run From Source

git clone <your-repo-url>
cd codex-tools
swift run CodexTools

Or open CodexTools.xcodeproj and run the CodexTools target.

Configuration

• CODEX_HOME (default: ~/.codex)
• CODEX_TOOLS_HOME (default: ~/.codex-tools)
• Active auth file: ${CODEX_HOME}/auth.json
• Account store: ${CODEX_TOOLS_HOME}/accounts.json
• Stored auth files use restrictive permissions (0600)

Development

swift test

Current Limits

• auth.json imports require token-based auth data (API-key-only imports are rejected)
• API-key accounts report usage as unavailable