What is AI Usage?
AI Usage is a command-line tool that tracks credit consumption across billing cycles for subscription-based AI services like Cursor and GitHub Copilot. It helps you avoid overages by projecting usage and providing clear consumption metrics.
Features
- Real-time analysis — compares your credit depletion rate against time elapsed in the billing cycle
- Smart projections — forecasts final usage based on current consumption velocity
- Color-coded feedback — visual indicators showing whether you’re conserving or over-consuming credits
- Flexible billing — supports any renewal day of the month
- Privacy-first — entirely offline with no external dependencies or data collection
Installation
uv tool install aiusage
# or
pip install aiusage
Requires Python 3.13 or later.
Usage
aiusage 15 45 # Renewal on 15th, current usage 45%
aiusage 25 # Default renewal (1st of month), usage 25%
Finding Your Usage
- Cursor: Settings > Search “Usage Summary” > Set to “Always”
- GitHub Copilot: Check your GitHub billing dashboard
How It Works
AI Usage calculates three metrics: time progress (days elapsed vs. total cycle days), usage ratio (current credit percentage vs. time percentage), and a projection estimating total usage at your current consumption rate. Color-coded output tells you at a glance whether you’re on track.