Shuvquota — AI skill for Claude Code

shuvquota

Multi-provider quota monitor and account manager for OpenAI Codex CLI, Claude Code, Factory.ai, SuperGrok, Synthetic, Google AI Pro / Antigravity, and OpenCode Go. Add, switch, list, and remove supported accounts with OAuth browser authentication, and inspect all configured quotas together.

By default, shuvquota now only reads and refreshes credentials from its own managed account files and env vars. Native app auth files from Codex CLI, OpenCode, Claude Code, and pi are no longer imported automatically, which avoids breaking those apps' tokens during refresh. Use `--native` to opt back into the old behavior when needed.

Zero dependencies - uses Node.js built-ins only.

Installation

npm install -g shuvquota

Or with bun:

bun add -g shuvquota

After installation, both `shuvquota` and `cq` commands are available.

Quick Start

# Add a new account (opens browser for OAuth)
shuvquota codex add personal

# Add a Claude credential (interactive)
shuvquota claude add work

# Add a Factory account (imports from Droid CLI auth.v2 files)
shuvquota factory add work

# Check quota for all accounts
shuvquota

# Open the installable quota dashboard
shuvquota-server

# Switch active Codex account
shuvquota codex switch personal

# Switch Claude credentials
shuvquota claude switch work

# Switch Factory account
shuvquota factory switch work

# Sync activeLabel to CLI auth files
shuvquota codex sync
shuvquota claude sync

# Preview sync without writing files
shuvquota codex sync --dry-run
shuvquota claude sync --dry-run

# List accounts
shuvquota codex list
shuvquota claude list
shuvquota factory list
shuvquota synthetic list

# Remove an account
shuvquota codex remove old-account
shuvquota claude remove old-account
shuvquota factory remove old-account
shuvquota synthetic remove default

shuvquota PWA

`shuvquota` is the installable, responsive companion app for the same quota data shown by the CLI. It presents Codex, Clau