Track your AI coding tool usage limits right in VS Code status bar.
QuotaWatch monitors your Codex CLI usage in real-time, alerts you before you hit limits, and helps you save tokens with smart repository analysis.
Features
Free
- Status Bar Usage Display — See your current usage % at a glance
- Threshold Alerts — Get notified at 50%, 75%, 90%, and 95% usage
- Velocity Alerts — Warns when usage climbs unusually fast (runaway loops, oversized prompts)
- Repository Analysis — Scan your project for files that waste AI context
- Markdown Reports — Generate detailed reports on your repo's AI readiness
Pro
- Usage Chart — Visual timeline of your usage with peak/average stats (canvas-based, dark/light theme)
- Export to CSV — Download your usage history for external tracking
- Daily & Weekly Summaries — Quick stats on your consumption patterns
- Usage Prediction — See when you'll hit your limit at current burn rate
- Custom Alert Thresholds — Set your own warning levels (VS Code settings)
- .codexignore Generator — Auto-generate ignore files to reduce token waste
Getting Started
- Install QuotaWatch from the VS Code Marketplace
- Run a Codex session — QuotaWatch automatically picks up your usage data
- Look at the status bar (bottom-right) for your current usage %
- Hover over the status bar item for detailed stats
Commands
Open the Command Palette (Ctrl+Shift+P) and type:
| Command | Description |
|---|---|
QuotaWatch: Refresh Usage |
Force an immediate usage check |
QuotaWatch: Analyze Repository |
Scan workspace for context waste |
QuotaWatch: Show Usage Chart [Pro] |
Open usage timeline chart |
QuotaWatch: Export Usage to CSV [Pro] |
Download usage history |
QuotaWatch: Daily Summary [Pro] |
View last 24 hours stats |
QuotaWatch: Weekly Summary [Pro] |
View last 7 days stats |
QuotaWatch: Generate .codexignore [Pro] |
Create ignore file for Codex |
QuotaWatch: Activate License |
Enter your Pro license key |
Settings
Open Settings (Ctrl+,) and search for quotawatch:
| Setting | Default | Description |
|---|---|---|
quotawatch.alertThresholds |
[50, 75, 90, 95] |
Usage % levels that trigger alerts |
quotawatch.velocityThreshold |
4 |
Points-per-minute rate for velocity alerts |
quotawatch.pollIntervalSeconds |
8 |
How often to check usage (seconds) |
Pricing
Free — Status bar tracking, alerts, repository analysis
Pro ($5.99 one-time) — Chart, CSV export, summaries, prediction, custom thresholds, .codexignore generator
Purchase at Payhip
Requirements
- VS Code 1.85 or newer
- OpenAI Codex CLI installed and used at least once
How It Works
QuotaWatch reads Codex CLI's local session transcripts from ~/.codex/sessions/. It parses the latest token_count event to extract rate-limit data (used %, reset time, plan type). No data is sent anywhere — everything stays local on your machine.
License
Proprietary. All rights reserved.
Support
- Email: [email protected]