keeping track of your AI quotas

your status bar already shows your CPU, memory, and battery — why not your AI quota too?

i built AI Status because i got tired of hitting rate limits mid-session. it's a lightweight module that monitors usage limits across seven AI providers — Claude, Copilot, Codex, Z.AI, Kiro, Antigravity, and OpenCode — all in real time

what it does

• multi-provider. tracks API usage limits across seven AI services simultaneously, so you always know where you stand

• live updates. auto-refreshes every 5 minutes with animated loading states. no polling, no manual refresh

• tooltip detail. hover over the module to see a per-provider breakdown with progress bars, percentages, and reset timers

• configurable. right-click to open an interactive TUI — enable, disable, or reorder providers without editing config files

• zero dependencies. pure Python and Bash. no NPM, no Node, no system-level packages. one command installs and keeps it up to date

how it works

a Python daemon runs persistently in the background, fetching usage data from all enabled providers in parallel. each provider has a query.sh (raw data fetching) and a parse.py (structured formatting), making it straightforward to add new providers

the daemon outputs structured JSON data, with a status icon and a detailed tooltip showing progress bars and reset timers. scroll up/down to switch between providers, middle-click to cycle metric types (rolling → weekly → monthly)

why it matters

if you work with AI tools daily, you know the pain of being cut off at the worst moment. this module puts your quota front and center — in your status bar, always visible, always up to date

check out the source code and install it with a single command:

curl -fsSL https://ai-status.gelzin.com/install | bash