Summary usage is a macOS menu bar app providing real-time visibility into Claude Code, Codex, and Antigravity (Gemini) quota, token usage, and costs. It targets macOS developers needing proactive usage management to prevent costly mid-session interruptions. The app offers passive, local-only monitoring, enhancing workflow efficiency and cost awareness without consuming additional API tokens.

How It Works usage passively reads quota and usage data directly from local log files generated by Claude Code, Codex, and the Antigravity CLI. This local-first approach eliminates API calls to Anthropic or OpenAI, ensuring zero token consumption and enhanced privacy by avoiding Keychain access. Antigravity quota is fetched securely using the existing local CLI OAuth token. This design provides immediate, on-screen feedback crucial for managing AI resource consumption during development.

Quick Start & Requirements

• Primary Install: brew install --cask aqua5230/usage/usage (Homebrew Cask). Direct download from GitHub Releases is also available.
• Prerequisites: macOS. Prior usage of Claude Code, Codex, or Antigravity required for local data. Source code execution needs Python 3.13.
• Links: GitHub Releases

Highlighted Details

• Live Visibility: Always-on menu bar monitor with color-coded quota status and detailed breakdowns.
• Workflow Helpers: Features like "Progress Concierge" automatically pass recent context to AI sessions; "Token Saver" toggles terser AI responses.
• Usage Insights: Generates deep HTML reports on daily/weekly trends, project costs, and includes a "Year in Review".
• Customization: Offers 10 visual themes (e.g., Windows 95, Matrix) and drag-to-reorder of quota cards.
• AI Talent Market: Enables local browsing and installation of curated AI subagent personas.
• Health Check: Daily background scans identify potential token waste in logs.
• Spirit Companions: Animated icons visually represent each AI tool's activity.

Maintenance & Community Hosted on GitHub with a link to Discussions. No specific details on active maintainers, sponsorships, or dedicated community channels (Slack/Discord) are provided.

Licensing & Compatibility

• License: AGPL-3.0-only.
• Compatibility: AGPL-3.0 is a strong copyleft license. Modified versions distributed must also be AGPL-3.0, potentially restricting integration into closed-source commercial applications.

Limitations & Caveats macOS-exclusive. Initial setup requires prior AI tool usage for local data. Advanced features (Progress Concierge, Token Saver) are opt-in and require configuration. Older versions had a py2app bundling bug affecting arm64.