gelzinn/ai-status

AI Status is a monitoring tool that shows how much of your AI usage limits you have left, displayed right in Waybar, the status bar used on Linux desktops running window managers like Hyprland or Sway. It tracks usage across seven different AI services at once: Claude, GitHub Copilot, Codex, Z.AI, Kiro, Antigravity, and OpenCode. The status bar shows a percentage for whichever provider is currently active, and you can scroll up or down to switch between providers. Hovering over the module opens a tooltip with a full breakdown for every provider, including progress bars, percentages, and countdown timers for when each limit resets. Middle clicking cycles through different types of limits for the active provider, such as rolling, weekly, and monthly usage. Right clicking opens a small interactive menu where you can turn providers on or off and change the order they appear in. Behind the scenes, a background program written in Python runs continuously, checking usage data from every enabled provider in parallel roughly every five minutes. Each provider has its own pair of scripts: one that fetches the raw data and one that formats it into a consistent structure, which the project says makes it straightforward to add support for new providers later. The tool reads credentials from files that already exist on your machine, such as OpenCode session tokens or Copilot login sessions, and the project states it does not include or store any API keys or tokens itself. Installation is done with a single command that downloads and runs an install script. That script can automatically add and configure the module in your Waybar settings for you, after first backing up your existing configuration, and everything can be reverted with a single command if needed. The same install command can be run again later to update to a newer version. The tool has no external dependencies beyond Python and Bash, requiring no Node.js or other system packages. It was previously named omarchy-ai-status, and older configurations are migrated automatically during installation, though the Waybar config itself needs to be updated by hand to use the new command name.