https://github.com/kitze/codexmaxx
https://github.com/kitze/codexmaxx
Last synced: 9 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/kitze/codexmaxx
- Owner: kitze
- License: mit
- Created: 2026-05-07T19:49:41.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-07T20:42:14.000Z (about 1 month ago)
- Last Synced: 2026-05-07T22:07:29.714Z (about 1 month ago)
- Language: Swift
- Size: 5.17 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CodexMaxx
macOS app for switching Codex accounts, tracking usage, load balancing profiles, and monitoring active Codex sessions.
CodexMaxx reads local Codex OAuth credentials from your machine, fetches Codex usage windows, and lets you switch between stored Codex profiles from the menu bar or the main window.
## Download
Download the latest stable build from [releaseflow.net/kitze/codexmaxx](https://releaseflow.net/kitze/codexmaxx).
## Features
- Combined or active-account menu bar usage.
- Session and weekly Codex quota display.
- Account switching without a CLI, including click-to-switch account cards.
- Profile deletion from account menus.
- Main dashboard with account grid, weekly usage chart, and GitHub-style activity graph.
- Active Codex session monitoring with session count, optional menu bar status, idle blinking, and idle beep alerts.
- Optional Codex-only load balancing across stored profiles.
- Configurable load balancer strategies: capacity weighted, usage weighted, or round robin.
- Main window and settings window for when the menu bar is crowded.
- Optional email hiding for privacy.
- Text, stacked-bar, and circular menu bar display modes.
- Local profile storage under `~/.codexmaxx`.
- Separate Dev variant storage under `~/.codexmaxx-dev`.
## Add Multiple Accounts
CodexMaxx saves whatever account is currently active in the Codex CLI. To add multiple accounts, use `codex login` for each account and then save it from the CodexMaxx menu.
1. Log in to the first account with the Codex CLI:
```bash
codex login
```
2. Open CodexMaxx and choose `Add Current Account...`. Give the profile a clear name, such as `work` or `personal`.
3. Log in to the next account with the Codex CLI:
```bash
codex login
```
4. Choose `Add Current Account...` again and save this account under a different profile name.
Repeat this flow for every account you want to manage. Switching copies the selected saved profile into `~/.codex`, so the Codex CLI and CodexMaxx use the same active account.
## Build
```bash
swift build -c release --product CodexMaxx
```
## Install Locally
```bash
./Scripts/package_app.sh
open CodexMaxx.app
```
## Privacy
CodexMaxx stores copied Codex profile files in `~/.codexmaxx/profiles/codex` and backs up switched files under `~/.codexmaxx/backups`. Deleting a profile removes its saved CodexMaxx copy and metadata, but does not delete your live `~/.codex` files.
Do not commit `~/.codex`, `~/.codexmaxx`, `auth.json`, or local release credentials.
## Credits
CodexMaxx was inspired by [CodexBar](https://github.com/steipete/codexbar) by [@steipete](https://github.com/steipete) and account-switching ideas from [aisw](https://github.com/burakdede/aisw) by [Burak Dede](https://burakdede.com/).
## License
MIT