niederme/ai-quota

AIQuota

A native macOS menu bar app for monitoring AI coding quota. Track OpenAI Codex and Claude Code from the menu bar and desktop widgets without living in a browser tab.

The marketing site in docs/ follows the shared Codex web preview convention using /Users/niederme/.codex/bin/codex-preview-env. The canonical global convention lives at /Users/niederme/.codex/docs/web-preview-convention.md.

---

Features

• Menu bar gauge — a compact, color-coded arc icon that tracks the selected service and shifts from purple to amber to red as you approach the limit
• Popover dashboard — Codex and Claude Code both use the same dual-arc gauge language: the 5-hour window is the outer ring, the 7-day window is the inner ring
• Service details that matter — reset timers, plan info, credits or extra usage, and clear warning states are visible at a glance
• Desktop widgets — polished widget variants for single-service and dual-service monitoring, including configurable small and medium widgets plus a large two-service layout
• Graceful empty and loading states — widgets and the popover keep a stable layout when a service is disconnected, restoring, or waiting on fresh data
• Adaptive refresh controls — choose Auto to refresh every minute when the app is active or quota is near a threshold, then back off automatically when idle, offline, or on low power
• Guided onboarding — first launch walks through connecting services, refresh preferences, notifications, and widget setup; if both services are connected, onboarding also asks which one should drive the menu bar icon
• Single-service adaptation — when only one service is enrolled,