Claude Pulse
https://github.com/santifer/claude-pulse- Category
- Developer Tools
- Rank
- No. 1727Tools index
Previous survey · No. 1721 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- santifer
- GitHub
- 9 stars
- Date
About
SwiftBar plugin for macOS providing real-time Claude API usage monitoring with rate limit predictions and smart alerts.
What it does
Claude Pulse turns quota consumption into a pacing signal. It compares used capacity with elapsed time in Claude’s five-hour and seven-day windows, then uses colors to show whether the current pace is sustainable. Its menu also exposes reset timing, recent sessions, productivity statistics and configurable notifications.
Why it's ranked here
This is a focused answer to an annoying Claude Code problem: quota percentages alone do not reveal whether usage is running ahead of schedule. The burn-rate comparison adds that missing context, while reset timing and threshold notifications make the result actionable. Its narrow platform and dependency requirements limit the audience.
What's good
The pacing model is easy to interpret: green means sustainable, while yellow, orange and red indicate increasing risk of early exhaustion. It handles both quota windows separately, can resume recent sessions from the menu and lets users configure alert thresholds, cooldown duration, session count and optional display sections.
Tradeoffs
It requires macOS, SwiftBar, jq and an active Claude Code OAuth session. Installation involves copying an executable Bash script into SwiftBar’s plugin folder. The plugin reads credentials from macOS Keychain and calls Anthropic’s OAuth usage endpoint every minute, so it is neither cross-platform nor a standalone desktop application.
How to use it well
It suits frequent Claude Code users who need a persistent signal for pacing work across short and weekly quota windows. Keep it in the menu bar during long coding sessions, then use its colors, reset estimates and alerts to decide when to slow down. It does not manage billing, increase limits or replace Claude Code.
Technical notes+
README.md documents Homebrew installation of SwiftBar and jq, configuration, macOS requirements and the MIT license. claude-pulse.1m.sh is a Bash SwiftBar plugin scheduled by its name to refresh every minute. It retrieves the Claude Code OAuth token through the macOS security command, queries Anthropic with curl, parses JSON using jq and computes burn-rate colors with awk. The script also parses reset timestamps with BSD date, supports configurable alerts and display options, and includes special green states for usage below 20 percent or a reset approaching within 7 percent of the window.
Observed
- License
- MIT
- Primary language
- Bash
- Platform
- macOS
- Interface
- SwiftBar menu bar plugin
- Installation surface
- Homebrew dependencies plus an executable script copied into the SwiftBar Plugins folder
- Runtime dependencies
- SwiftBar, jq, curl, awk, macOS Keychain and an active Claude Code OAuth session
- Documentation
- English and Spanish README files
Read from README.md, README.es.md, claude-pulse.1m.sh.
What it can do
Monitor Claude API usage in real-time
Claude API requests and responses → Live usage statistics and metrics
Predict rate limit violations
Current API usage patterns and rate data → Rate limit predictions and warnings
Display API usage in macOS menu bar
Claude API usage data → Menu bar widget with usage information
Send smart alerts for usage thresholds
API usage levels and predefined thresholds → Automated notifications and alerts
Track API request counts and quotas
Claude API request logs → Request count summaries and quota status
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.