Claude Usage IntelliJ Plugin

A simple IntelliJ plugin that displays your Claude subscription usage in the IDE status bar.

Note: This plugin shows Claude subscription usage limits only (5-hour, 7-day quotas). It does not track API token usage, costs, or conversation history.

Features

• Real-time usage percentage in the status bar with automatic refresh every 60 seconds
• Manual refresh button in the popup for instant updates
• Color-coded progress indicator (green → yellow → red)
• Time until quota reset
• Detailed popup with all usage tiers (5-hour, 7-day, 7-day Sonnet, extra usage)
• Dark and light theme support
• Error state display with actionable hints (missing credentials, auth expired, network issues)
• Last fetch timestamp in the popup
• Configurable settings (Settings → Tools → Claude Code Usage):
  • Status bar quota display (5-hour, 7-day, or 7-day Sonnet)
  • Warning color thresholds (yellow/red)
  • Custom credentials file path
  • Reset to defaults button
• Direct link to Claude settings

Requirements

• IntelliJ IDEA 2024.1+ (works with all JetBrains IDEs: WebStorm, PyCharm, RubyMine, etc.)
• Claude Code CLI installed and authenticated

The plugin reads credentials from ~/.claude/.credentials.json which is created when you sign in to Claude Code CLI.

Development

Prerequisites

• JDK 17+
• Gradle 8.5+ (wrapper included)

Build

./gradlew buildPlugin

Output: build/distributions/claude-usage-intellij-plugin-x.x.x.zip

Run in sandbox IDE

./gradlew runIde

This launches a sandboxed IntelliJ instance with the plugin installed.

Clean build

./gradlew clean buildPlugin

Installation

From JetBrains Marketplace (recommended)

1. In your IDE: Settings → Plugins → Marketplace
2. Search for "Claude Code Usage"
3. Click Install

Or install directly: JetBrains Marketplace

From source

1. Build the plugin: ./gradlew buildPlugin
2. In your IDE: Settings → Plugins → ⚙️ → Install Plugin from Disk
3. Select build/distributions/claude-usage-intellij-plugin-x.x.x.zip
4. Restart the IDE

Usage

Once installed, you'll see your usage in the status bar (bottom right). Click to see detailed breakdown of all quota tiers.

Roadmap / Feature Ideas

• Usage history graph over time
• Export usage statistics

Contributing

Contributions welcome! Please open an issue first to discuss proposed changes.

License

MIT