⚠️ Beta Release — This is an early release (v0.1.0). Features may change and some functionality may be incomplete. Please report issues on GitHub.
TokenPulse β is an IntelliJ IDEA plugin that aggregates token balances and credit usage across multiple AI providers directly in your IDE status bar.
- 📊 Live Aggregate Balance — See your total remaining credits/tokens at a glance in the status bar.
- 🤖 Multi-Provider Support — Supports:
- OpenRouter — Provisioning Key with credits tracking
- Cline — API Key for personal and organization accounts
- OpenAI Platform — Admin API Key (
sk-admin-...) for organization usage/cost data - ChatGPT Subscription — OAuth flow for Pro/Plus subscription tracking
- Nebius AI Studio — Cookie-based auth with trial/paid balance
- Claude Code — CLI-based usage extraction via
claudecommand
- 🔄 Smart Refresh — Configurable auto-refresh with TTL caching and single-flight coalescing to avoid rate limits.
- 🔐 Secure Storage — API keys are stored securely using IntelliJ's built-in
PasswordSafe. - 📈 Dashboard Overview — Detailed table view showing per-account provider, key preview, status, last refresh time, and credits.
- 📉 Balance History Chart — Visual chart showing balance trends over time (24h, 7d, 30d, all time).
- 🚀 Onboarding & Updates — Friendly welcome notification for new users and "What's New" highlights after updates.
- Open IntelliJ IDEA →
Settings→Plugins - Search for "TokenPulse" in Marketplace
- Click
Install
- Download the latest
token-pulse-*.zipfrom Releases - Open IntelliJ IDEA →
Settings→Plugins - Click the ⚙️ icon →
Install Plugin from Disk... - Select the downloaded ZIP file
- Open Settings → Tools → TokenPulse β.
- Click + to add a provider account:
- Select the Provider (Cline, OpenRouter, Nebius, OpenAI, ChatGPT, or Claude).
- Follow the provider-specific instructions in the dialog.
- Configure the Refresh Interval (default: 15 minutes).
- The aggregate balance appears in your status bar automatically.
| Provider | Auth Type | How to Connect |
|---|---|---|
| Cline | API Key | https://app.cline.bot/dashboard/account?tab=api-keys |
| OpenRouter | Provisioning Key | https://openrouter.ai/settings/provisioning-keys |
| OpenAI Platform | Admin API Key (sk-admin-...) |
https://platform.openai.com/settings/organization/admin-keys |
| ChatGPT Subscription | OAuth | Click "Sign in with ChatGPT" in the dialog |
| Nebius AI Studio | Billing Session | Click "Connect Billing Session →" and follow the 3-step guide |
| Claude Code | CLI | Requires claude CLI installed and authenticated |
Tip: If you add multiple accounts for the same provider, each entry shows a partial key preview (e.g.
sk-or-…91bc) so you can tell them apart at a glance.
TokenPulse β offers flexible status bar display options:
- Auto Mode — Adapts based on your first provider (shows % for Claude/ChatGPT, $ for others)
- Total Dollars — Shows combined balance across all dollar-based providers
- Single Provider — Shows data from a specific selected provider
Configure display preferences in Settings → Tools → TokenPulse β.
TokenPulse reads your credit/balance from each provider's API. OAuth-issued tokens do not have access to the balance/credits endpoints on Cline or OpenRouter — only manually generated keys do. This is a provider-side limitation, not a plugin choice.
Nebius AI Studio does not expose a billing API accessible via API key. TokenPulse reads your trial balance from the same internal billing gateway used by the Token Factory web UI.
The "Connect Billing Session →" dialog walks you through a 3-step process:
- Open the Nebius billing page in your browser and log in.
- Open the browser console (F12 → Console) and run the one-line script shown in the dialog.
- Copy the output (a small JSON blob) and paste it into the dialog.
OpenRouter's regular API keys do not expose the /api/v1/credits endpoint. Only
Provisioning Keys return credit balance information.
You can create a Provisioning Key at: https://openrouter.ai/settings/provisioning-keys
OpenAI's Organization Usage API and Organization Costs API provide access to organization-wide usage and cost data. TokenPulse fetches:
- Credits used — Total cost from the
/v1/organization/costsendpoint - Tokens used — Sum of input, output, cached input, and reasoning tokens from the
/v1/organization/usage/completionsendpoint
Admin API Key required: Only Admin API Keys (
sk-admin-...) have access to the Organization APIs. Regular project/personal keys will be rejected. Admin keys are created at: https://platform.openai.com/settings/organization/admin-keys
ChatGPT Pro/Plus users can sign in via OAuth to track their subscription usage. The plugin uses the same OAuth flow as the official ChatGPT clients (PKCE-based authentication).
When Codex integration is enabled (requires Codex CLI), TokenPulse can display detailed rate limit usage including 5-hour, weekly, and code review quotas.
Claude Code integration uses the claude CLI tool. The plugin executes claude commands to
extract usage information including 5-hour and weekly utilization percentages.
You need to have the Claude CLI installed and authenticated first:
npm install -g @anthropic-ai/claude-code
claude loginYes. Keys are stored in IntelliJ's PasswordSafe (OS keychain on macOS/Windows, encrypted file
on Linux). They are never written to plain-text settings files.
- Auth Error — the key is invalid or has been revoked. Re-generate it from the provider's dashboard.
- Rate Limited — too many requests. Increase the refresh interval in Settings → TokenPulse β.
- Error — a network or API error. Check your internet connection and try "Refresh All" from the dashboard.
- $X.XX used — OpenAI account showing usage data (not a balance).
- IntelliJ Platform — 2024.2+ (build 242+) through 2025.1.x
- Java — 21 (LTS)
- IDEs — IntelliJ IDEA (Community & Ultimate), WebStorm, PyCharm, and other JetBrains IDEs
See DEVELOPMENT.md for detailed instructions on building and testing the plugin.
This project is licensed under the MIT License — see the LICENSE file for details.