⚠️ Beta Release — This is an early release (v0.2.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 (Codex CLI) — CLI-based usage tracking via Codex CLI
  • Nebius AI Studio — Cookie-based auth with trial/paid balance
  • Claude Code — CLI-based usage extraction via claude command
• 🔄 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.

1. Open IntelliJ IDEA → Settings → Plugins
2. Search for "TokenPulse" in Marketplace
3. Click Install

1. Download the latest token-pulse-*.zip from Releases
2. Open IntelliJ IDEA → Settings → Plugins
3. Click the ⚙️ icon → Install Plugin from Disk...
4. Select the downloaded ZIP file

1. Open Settings → Tools → TokenPulse.
2. Click + to add a provider account:
   • Select the Provider (Cline, OpenRouter, Nebius, OpenAI, ChatGPT, or Claude).
   • Follow the provider-specific instructions in the dialog.
3. Configure the Refresh Interval (default: 15 minutes).
4. The aggregate balance appears in your status bar automatically.

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:

1. Open the Nebius billing page in your browser and log in.
2. Open the browser console (F12 → Console) and run the one-line script shown in the dialog.
3. 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/costs endpoint
• Tokens used — Sum of input, output, cached input, and reasoning tokens from the /v1/organization/usage/completions endpoint

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 login

Yes. 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.