NoobyGains/claude-pulse
Real-time usage monitor for Claude Code — session limits, weekly limits, and plan tier with colour-coded progress bars
What it solves
Claude Code users often lack real-time visibility into their usage limits, costs, and session state. claude-pulse provides a highly customizable, real-time status bar that integrates directly into the Claude Code terminal interface, allowing users to track session and weekly limits, context window usage, and API costs without leaving their workflow.
How it works
The tool is a single-file Python script that acts as a plugin for Claude Code. It reads session data (including model, context, cost, and rate limits) piped via stdin from Claude Code on every status refresh. It then processes this data and renders a colorized ANSI status line.
Optional hooks can be installed to track tool usage (heartbeat) and Git branch changes in real-time. To maintain performance, it uses a local cache for exchange rates and update checks, and it avoids making direct API calls for usage data by reading them directly from the stdin payload.
Who it’s for
Developers using Claude Code with a Pro or Max subscription who want a visual, real-time dashboard of their resource consumption and session metrics.
Highlights
- Comprehensive Tracking: Monitors session and weekly limits, per-model caps (Opus, Sonnet, Fable), and live context window usage.
- Zero-Dependency Python: A single-file installation with no external pip dependencies required.
- Real-time Costing: Tracks session cost in over 25 currencies with live exchange rates.
- Deep Customization: Features 10 themes, 5 animation modes, and 8 different bar styles.
- Developer Metrics: Displays Git branch, lines changed, active subagents, and cache efficiency.
- Integrated Tools: Includes a built-in focus timer and automatic update notifications for both the plugin and Claude Code.
Related
- Project
- Project
- Project
- Project
- Project