A TUI for switching between Codex accounts and monitoring quota usage, written in Go using Bubble Tea.
- Fast account switching across many accounts
- Multi-target apply across Codex, OpenCode, Pi, and OMP harnesses
- Accounts loaded from local app storage plus the external Codex, OpenCode, Pi, and active-profile OMP stores
- OAuth authentication via browser
- Configurable auto-refresh: the active account refreshes on a short interval, the rest on a longer background interval
- Two view modes: compact for many accounts, tabs for focused viewing when you have just a few.
Homebrew:
brew install deLiseLINO/tap/codex-quotaGo install:
go install github.com/deLiseLINO/codex-quota/cmd/cq@latestNote: Make sure your Go bin directory is available in PATH.
Build from source
git clone https://github.com/deLiseLINO/codex-quota.git
cd codex-quota
go install ./cmd/cqRun the app:
cqTypical flow:
- Press
nto add/import account via OAuth. - Move between accounts with arrows.
- Press
Enterto open the actions menu for the active account and app-level actions. - Press
oto apply the active account to selected targets. - Use
r/Rto refresh quota and?for grouped keyboard help.
↑↓←→— both work for navigation; the UI highlights↑/↓in compact view and←/→in tabs viewEnter— open actions menu for account and app-level actionsr— refresh active accountR— refresh all accountsv— switch view mode (also available via actions menu)s— open settings (auto-refresh intervals, update check)?— open grouped keyboard helpq/Ctrl+C— quit
Additional shortcuts:
hjkl— Vim-style navigationo— apply active account to selected targetsi— toggle additional infon— add account (OAuth)x— delete active accountu— open update prompt when an update is availableEsc— close modal/info/error/notice (or quit if nothing is open)

