I put my Claude usage limits on my desktop (a PowerShell WPF widget and a SwiftBar plugin)

Description and use

Widgets for Windows and macOS display Claude usage limits in real time, preventing unexpected limit messages.

Problem

Users of Claude often hit usage limits unexpectedly, interrupting workflow.

Outcome

The widgets keep users informed of Claude usage limits in real time, reducing interruptions caused by unexpected limit messages.

Workflow

• 1. Retrieve organization UUID via GET https://claude.ai/api/organizations using sessionKey cookie.
• 2. Fetch usage data via GET https://claude.ai/api/organizations/{org_uuid}/usage.
• 3. Parse JSON for five_hour, seven_day, seven_day_opus, seven_day_sonnet utilization and resets_at.
• 4. Update UI elements every 5 minutes; recompute countdowns locally each minute.
• 5. On Windows, run a single PowerShell .ps1 script that loads a WPF XAML UI, uses a background runspace to fetch data, and a DispatcherTimer to update the UI without blocking.
• 6. On macOS, run a SwiftBar plugin that performs the same API calls and updates the menu bar item.
• 7. If sessionKey is missing, fall back to OAuth token in ~/.claude/.credentials.json and call api.anthropic.com/api/oauth/usage.

Evidence

There's no public API for this, so the widgets call the same endpoints as the claude.ai web app, authenticated with your browser's sessionKey cookie:

Source

Both are a single script each, need no install beyond what ships with the OS, and are open source: 👉 github.com/advancedcognitivesystems-ai/claude-usage-widgets

Source

⚠️ These are undocumented internal endpoints. They can change any day, and this project isn't affiliated with Anthropic.

Source