Skip to content

About

Terminal interface for Codex quota monitoring and account switching across Codex and OpenCode

Resources

Stars

80 stars

Watchers

0 watching

Forks

Repository files navigation

CQ (Codex Quota)

A TUI for switching between Codex accounts and monitoring quota usage, written in Go using Bubble Tea.

Screenshot

Demo

Features

  • 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.

Installation

Homebrew:

brew install deLiseLINO/tap/codex-quota

Go install:

go install github.com/deLiseLINO/codex-quota/cmd/cq@latest

Note: 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/cq

Usage

Run the app:

cq

Typical flow:

  1. Press n to add/import account via OAuth.
  2. Move between accounts with arrows.
  3. Press Enter to open the actions menu for the active account and app-level actions.
  4. Press o to apply the active account to selected targets.
  5. Use r/R to refresh quota and ? for grouped keyboard help.

Controls

  • ↑ ↓ ← → — both work for navigation; the UI highlights ↑/↓ in compact view and ←/→ in tabs view
  • Enter — open actions menu for account and app-level actions
  • r — refresh active account
  • R — refresh all accounts
  • v — switch view mode (also available via actions menu)
  • s — open settings (auto-refresh intervals, update check)
  • ? — open grouped keyboard help
  • q / Ctrl+C — quit

Additional shortcuts:

  • h j k l — Vim-style navigation
  • o — apply active account to selected targets
  • i — toggle additional info
  • n — add account (OAuth)
  • x — delete active account
  • u — open update prompt when an update is available
  • Esc — close modal/info/error/notice (or quit if nothing is open)

About

Terminal interface for Codex quota monitoring and account switching across Codex and OpenCode

Resources

Stars

80 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages