aqua5230/usage

What it solves

usage provides real-time visibility into the token quotas and usage limits of AI coding tools like Claude Code, Codex, and Antigravity. It prevents developers from unexpectedly running out of quota during critical work sessions by surfacing 5-hour and weekly limits directly in the macOS menu bar or Windows system tray.

How it works

Instead of calling expensive LLM APIs, the tool primarily reads quota data passively from local log files already present on the user's machine. For Antigravity, it uses Google's official quota endpoint via existing local credentials. It also integrates a status line hook into the AI tools' terminal interfaces to keep limits visible during active sessions.

Who it’s for

Developers who use Claude Code, Codex, Antigravity, or Grok CLI and want to avoid mid-session quota exhaustion without manually checking usage pages.

Highlights

• Always-on Monitoring: Color-coded quota tracking in the system menu bar/tray with 14 customizable visual themes.
• Workflow Helpers: Includes a "Progress Concierge" to hand off last session state to AI and a "Token Saver" to force terser AI responses.
• AI Collaboration Tools: Features an "AI Council" for multi-model discussions and an "AI Talent Market" for installing curated subagent personas.
• Health & Reporting: Provides daily token-waste health checks and detailed HTML reports on token trends and costs.
• Privacy-First: Reads local logs for Claude Code and Codex, ensuring no LLM API calls are made to track quota.