Claude Pulse

Real-time usage monitor for Claude Code — session limits, weekly limits, cost tracking, peak hours, and 10 themes with animations. All in your status bar.

What is this?

A single-file Python status bar for Claude Code that shows everything you need at a glance — no API key required, zero dependencies, works with your existing Claude Code subscription.

Features:

• Session & Weekly bars: Colour-coded progress bars (green ? yellow ? red) for 5-hour session and 7-day weekly limits
• Context window: Live context usage percentage with pressure warnings at 70%/90%
• Cost tracking: Real-time session cost in your local currency (USD, GBP, EUR, + 25 more) with live exchange rates
• Peak hours: Configurable indicator for Anthropic's peak consumption window — red In Peak ? when limits burn faster, yellow when approaching, green Off-Peak ? when limits stretch further. Full and minimal display modes
• Live heartbeat: Spinning indicator with tool count and elapsed time (via PostToolUse hook)
• Git branch: Current branch name always visible
• Model display: Shows which model is active (Opus, Sonnet, Haiku)
• 10 themes: default, ocean, sunset, mono, neon, pride, frost, ember, candy, rainbow
• 5 animation modes: off, rainbow, pulse, glow, shift — each visually distinct
• 8 bar styles: classic, block, shade, pipe, dot, square, star, braille
• Lines changed: Shows +42 -7 in green/red — lines added and removed this session, read from stdin
• Cumulative cost: Opt-in widget showing total API-equivalent cost across all sessions (cached, 5-min refresh)
• Widget priorities: Every widget has a priority number — reorder them with --priority model=5,cost=15
• Focus timer: Built-in focus timer — --focus start 25 shows countdown in the status bar
• Auto-updates: Notifies when a new version of claude-pulse or Claude Code is available
• Staleness indicator: Shows data age when cached data is old
• Zero API calls: Reads rate limits directly from Claude Code's stdin (v2.1.80+) — no OAuth, no rate limiting