Claude Usage Monitor

About

A Chrome extension that monitors your Claude Code usage from claude.ai/settings/usage and displays it as a badge on the extension icon for quick visibility.

FEATURES:

• Badge Display: Shows current session usage percentage directly on the extension icon
• Color Coding: Badge color changes based on usage level (green < 50%, yellow 50-80%, red > 80%)
• Detailed Popup: Click the icon to see full usage details including:
  - Current session usage percentage (large display)
  - Weekly limit usage percentage (smaller display)
  - Reset time
  - Last updated timestamp
  - Status indicator (OK/Stale)
• Manual Refresh: Click the "Refresh" button in popup to fetch latest usage data anytime
• Auto-Refresh: Automatically refreshes usage data in the background at configurable intervals (5, 10, 15, 30, or 60 minutes)
• Weekly Limit Tracking: Displays weekly usage limits when available
• Stale Data Detection: Automatically marks data as stale after 30 minutes (configurable)
• Authentication Detection: Alerts when you need to log in to Claude
• Robust Parsing: Multiple fallback strategies to extract usage data from the page
• Options Page: Customize stale threshold, color preferences, and auto-refresh settings

HOW TO USE:

1. Log in to Claude at https://claude.ai
2. Visit https://claude.ai/settings/usage once to initialize data
3. The extension will automatically extract your current session usage percentage
4. The badge on the extension icon will update to show your usage
5. Click the icon to see detailed information
6. Use the "Refresh" button to fetch latest data anytime
7. Enable auto-refresh in Options to automatically refresh at regular intervals

BADGE STATES:

• Numeric percentage (e.g., "45"): Current session usage
• "⚠" or "AUTH" (orange): You need to log in to Claude
• "ERR" (red): Error parsing the usage page
• Gray badge: Data is stale (older than threshold)

PRIVACY & SECURITY:

• All data stored locally only - nothing transmitted externally
• No analytics, tracking, or telemetry
• No third-party services
• Minimal permissions (only what's necessary)
• Open source: https://github.com/RamboXWang/ClaudeCodeUsage

CONFIGURATION:

Right-click the extension icon and select "Options" to configure:
• Stale Data Threshold: How long before data is marked as stale (5-120 minutes)
• Color-Coded Badge: Enable/disable color coding based on usage level
• Auto-Refresh: Enable/disable automatic background refresh
• Refresh Interval: Choose how often to auto-refresh (5, 10, 15, 30, or 60 minutes)

This extension is perfect for Claude Code users who want to keep track of their usage without constantly visiting the usage page.