https://github.com/santifer/claude-pulse
SwiftBar plugin for macOS. Real-time Claude API usage monitoring with rate limit predictions and smart alerts.
https://github.com/santifer/claude-pulse
api-usage claude macos monitoring rate-limiting swiftbar
Last synced: 11 days ago
JSON representation
SwiftBar plugin for macOS. Real-time Claude API usage monitoring with rate limit predictions and smart alerts.
- Host: GitHub
- URL: https://github.com/santifer/claude-pulse
- Owner: santifer
- Created: 2026-01-26T16:30:04.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-26T16:37:12.000Z (5 months ago)
- Last Synced: 2026-06-10T21:24:24.913Z (15 days ago)
- Topics: api-usage, claude, macos, monitoring, rate-limiting, swiftbar
- Language: Shell
- Size: 1.2 MB
- Stars: 9
- Watchers: 0
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.es.md
Awesome Lists containing this project
README
# Claude Pulse
> [Read in English](README.md)
Plugin de SwiftBar para macOS que monitoriza el uso de la API de Claude en tiempo real. Rastrea límites de uso, predice cuándo alcanzarás los topes y te ayuda a gestionar tu consumo de forma inteligente.
## El Problema
Los usuarios de Claude Code alcanzan los límites de uso inesperadamente. La API tiene dos ventanas temporales (5 horas y 7 días) con límites separados, lo que dificulta saber cuándo estás consumiendo tu cuota demasiado rápido.
## La Solución
Claude Pulse se sitúa en tu barra de menú y muestra:
- **Uso en tiempo real** en ambas ventanas temporales (5h + 7d)
- **Código de colores inteligente** — verde/amarillo/naranja/rojo según la tasa de consumo vs tiempo restante
- **Predicciones de reset** — exactamente cuándo se restablecen tus límites
- **Sesiones recientes** — reanudar con un clic desde la barra de menú
- **Alertas de macOS** — notificaciones al 70% y 90% de uso
## Stack Tecnológico
## Instalación
```bash
# 1. Instalar dependencias
brew install --cask swiftbar
brew install jq
# 2. Copiar a la carpeta de plugins de SwiftBar
cp claude-pulse.1m.sh ~/Library/Application\ Support/SwiftBar/Plugins/
# 3. Hacer ejecutable
chmod +x ~/Library/Application\ Support/SwiftBar/Plugins/claude-pulse.1m.sh
```
**Requisitos:**
- macOS (usa Keychain para el token OAuth)
- SwiftBar
- jq
- Sesión OAuth activa de Claude Code
## Cómo Funciona
El plugin consulta la API OAuth de Anthropic cada minuto y calcula una "tasa de consumo" — comparando tu porcentaje de uso contra el tiempo transcurrido. Si estás usando el 50% de tu cuota pero solo ha pasado el 25% de la ventana temporal, vas camino de alcanzar el límite antes del reset.
### Lógica de Colores
| Color | Significado |
|-------|-------------|
| 🟢 Verde | A buen ritmo — tendrás cuota restante en el reset |
| 🟡 Amarillo | 30% más rápido de lo sostenible |
| 🟠 Naranja | 60% más rápido — reduce el ritmo |
| 🔴 Rojo | Agotarás antes del reset |
## Configuración (Opcional)
Crea `~/.claude-usage-config.json`:
```json
{
"alerts": {
"threshold_warning": 70,
"threshold_critical": 90,
"cooldown_minutes": 30,
"enabled": true
},
"display": {
"max_sessions": 5,
"show_velocity": true,
"show_streak": true,
"show_predictions": true
}
}
```
## Licencia
MIT
## Let's Connect
[](https://santifer.io)
[](https://linkedin.com/in/santifer)
[](mailto:hola@santifer.io)