aiq-monitor 0.1.0

AI Quota — monitor and switch AI coding subscription accounts

aiq — AI Quota

Monitor usage and switch between AI coding subscription accounts.

$ aiq
  AI Quota
  ────────────────────────────────────────────────────────────────────────
    TOOL     ACCOUNT                          5h            7d          STATUS
  ● claude   [e-mail]       ██████░░░░  62.3%  ████░░░░░░  38.1%  OK
    claude   [e-mail]                  —              —        --
  ────────────────────────────────────────────────────────────────────────
  ● codex    [e-mail]       ████████░░  81.0%  ██████████ 100.0%  LIMITED
    codex    [e-mail]         ██░░░░░░░░  15.2%  ███░░░░░░░  28.4%  OK
  ────────────────────────────────────────────────────────────────────────
  4 accounts · 2 ok · 1 limited · 1 unknown

What it does

• Check quotas across Claude Max, Codex (ChatGPT Pro), and Gemini Ultra accounts
• Switch accounts when you hit rate limits — auto-picks the one with most headroom
• Vault management — save, list, and remove credential profiles locally

Install

uv tool install aiq-monitor

Or from source:

git clone https://github.com/elyase/aiq.git
cd aiq
uv tool install .

Usage

aiq                        # show quota for all accounts
aiq use codex              # auto-pick best Codex account
aiq use claude alice@x     # switch to specific account
aiq add codex alice@x      # save current auth as profile
aiq logout codex           # remove auth files
aiq ls                     # list all vault profiles
aiq rm codex alice@x       # remove a vault profile
aiq import                 # import from caam vault / active creds
aiq --json                 # machine-readable output

How credentials work

aiq never stores passwords or API keys. It copies the OAuth/session files that each tool's CLI already writes to disk (e.g., ~/.codex/auth.json) into a local vault at ~/.local/share/aiq/vault/. All vault files are stored with 0600 permissions.

Supported tools and their auth sources:

Tool	Auth files read
Claude	~/.claude.json, macOS Keychain (Claude Code-credentials)
Codex	~/.codex/auth.json
Gemini	~/.gemini/settings.json, ~/.gemini/oauth_credentials.json

Agent setup

Give your AI coding agent the ability to monitor quotas and switch accounts automatically.

1. Install the CLI

uv tool install aiq-monitor

2. Install the skill

Using skills:

npx skills add elyase/aiq

This installs the aiq skill into your agent's skills directory. The agent will automatically use aiq when you hit rate limits or ask about quota.

3. Import your accounts

aiq import    # detects active logins for Claude, Codex, Gemini

Or add accounts manually:

# Log in to first account
claude           # /login with [e-mail]
aiq add claude [e-mail]

# Log in to second account
aiq logout claude
claude           # /login with [e-mail]
aiq add claude [e-mail]

# Switch back
aiq use claude [e-mail]

Now your agent can run aiq use claude to auto-switch when hitting limits.

Requirements

• Python 3.12+
• macOS (Keychain access for Claude; other tools work cross-platform)
• humancli framework

License

MIT