Claude Pulse

Overview

A native macOS menu-bar app that displays Claude Code usage in real time

Features

• Real-time usage tracking — See your current session, weekly (all models), and Sonnet-only limits at a glance
• Smart Usage Notification — Get notified before you hit your limits
• Menu bar percentage — Always-visible usage percentage right in your menu bar
• Session reset countdown — Know exactly when your limits reset
• Smart usage hints — Context-aware tips that appear as you approach your limits
• Auto-refresh — Configurable polling interval (30s to 10m) keeps data fresh
• Claude Code CLI login — Automatically detects Claude Code CLI credentials for instant sign-in without a browser
• Browser sign-in — Alternatively, authenticate with your Claude account via built-in web view
• Auto-updates — Sparkle-powered updates with EdDSA signature verification
• Right-click menu — Quick access to usage info, refresh interval, update check, and log out
• Stale data warnings — Visual indicator when data hasn't been refreshed recently
• Lightweight — Runs as a menu bar accessory with no Dock icon

Installation

Requires macOS 13 Ventura or later.

Step 1 — Download

Download the latest ClaudePulse.dmg from the Releases page.

Step 2 — Install

1. Double-click ClaudePulse.dmg to mount it
2. Drag ClaudePulse into the Applications folder shortcut

Step 3 — Log in to Claude

Claude Pulse supports two sign-in methods:

Option A — Claude Code CLI (recommended)

If you already use Claude Code and have run claude login, the app detects your CLI credentials automatically on first launch — no browser needed. Usage data loads instantly via the Anthropic API.

Option B — Browser

If you don't use Claude Code CLI, a browser window opens on first launch. Log in to your Claude account normally. The window closes by itself when login succeeds.

If both options are available, you can choose your preferred method from the sign-in screen.

How it works

Data sources

CLI API mode — When signed in via Claude Code CLI, the app reads your OAuth token and fetches usage data directly from the Anthropic API (GET /api/oauth/usage). The token is validated on each app launch to ensure it's still active. This mode provides session (5h), weekly (all models), and Sonnet-only utilization with exact reset times.

WebView mode — When signed in via browser, the app embeds a hidden WKWebView that loads claude.ai/settings/usage using your stored browser session (via WKWebsiteDataStore.default() — the same cookie store Safari uses for WebKit-based apps). A JavaScript fetch/XHR interceptor is injected at document start, before any page script runs. It captures every API response that mentions usage, limits, or quotas and forwards the raw JSON to Swift. A DOM-text extraction pass runs 5 s after page load as a fallback.

Cookie & credential persistence

• CLI mode: OAuth credentials are managed by Claude Code CLI. Claude Pulse reads them but never modifies them.
• WebView mode: WKWebsiteDataStore.default() persists cookies to disk between app launches automatically. If the session expires, the login window reappears.

License

MIT License. Feel free to use Claude Pulse and contribute.