A Raycast extension that monitors your Claude.ai usage limits directly from your menu bar.

Features

• Real-time Usage Monitoring - Track your Claude.ai usage limits at a glance
• Dual Time Windows - View both 5-hour and 7-day usage periods
• Color-coded Indicators - Green (< 70%), Orange (70-90%), Red (> 90%)
• Auto-refresh - Updates automatically every 10 minutes
• Reset Timers - See when your usage limits will reset
• Account Info - Display your subscription type (Pro, Free, etc.)
• Quick Actions - Refresh data or open Claude.ai with keyboard shortcuts

Prerequisites

• Raycast installed on macOS
• Claude Code CLI logged in with your Claude.ai account

The extension reads OAuth credentials from Claude Code CLI stored in your macOS Keychain. Make sure you're logged in via the CLI before using this extension.

Installation

1. Open Raycast
2. Search for "Claude Usage Tracker" in the Store
3. Click Install

Or install from source:

git clone https://github.com/ahmosys/claude-usage-tracker.git
cd claude-usage-tracker
npm install
npm run dev

Usage

Once installed, the extension appears in your menu bar showing your current usage percentage.

Menu Bar Display

The menu bar shows either your 5-hour or 7-day usage (configurable in preferences). Click the icon to see:

• Account - Your current subscription plan
• 5-Hour Usage - Short-term usage and reset time
• 7-Day Usage - Weekly usage and reset time

Keyboard Shortcuts

Shortcut	Action
Cmd + R	Refresh usage data
Cmd + O	Open Claude.ai in browser

Copying Values

Click on any usage or reset time item to copy it to your clipboard.

Configuration

Open Raycast Preferences > Extensions > Claude Usage Tracker to configure:

Preference	Description	Default
Show 5-hour usage in menu bar	Toggle between 5-hour and 7-day display	Enabled

Troubleshooting

"Login Required" or "No Claude credentials found"

This means the extension couldn't find your Claude Code CLI credentials. To fix:

1. Install Claude Code CLI
2. Run claude and complete the login flow
3. Restart the extension

"Failed to access Keychain"

The extension needs access to your macOS Keychain to read credentials. Make sure Raycast has the necessary permissions in System Preferences > Security & Privacy.

Development

# Start development server with hot reload
npm run dev

# Build the extension
npm run build

# Lint code
npm run lint

# Fix lint issues
npm run fix-lint

License

MIT