# claude-pulse

Draws session consumption, weekly caps, a reset countdown and your plan right in the Claude status line. Handy when you want a quick read without leaving the chat.

- plugin · `type=plugin` · Claude Code · ★ 465
- Author: NoobyGains
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NoobyGains/usage-pulse
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/plugins/claude-pulse

## What it does

The plugin keeps a live line below the prompt: how full the window is, time left until it resets, the plan, context and session spend. It works from what Claude already sends to the status line, so no API key and no polling.

Under the hood there is a single Python script with no dependencies, and it wants Python 3.8+. Colours, bar size and style, text layout and widgets are picked in a setup wizard with previews; `settings.json` is backed up before the first write. The plugin cannot register a status line on its own, so `/usage-pulse:setup` writes it into `settings.json` with safe defaults. Restart Claude afterwards.

One `SessionStart` hook comes along: when a plugin update moves the install into a new version folder, it points `settings.json` at the current one. Git and manual installs are left alone.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
In the agent chat (not a shell):
```text
/plugin install claude-pulse@claude-community
```

## When to use it
- check how much of the session window is left
- track weekly spend and the reset countdown
- see session cost in your own currency
- change theme and bar style without editing JSON
- count subagents spawned against the cap

## Example prompts
- Run `/usage-pulse:setup` and write the status line into `settings.json` with defaults
- Open `/usage-pulse:pulse setup` and pick a theme, bar style and widgets
- Show me `/usage-pulse:pulse providers` so I can see which subscriptions were found

## Similar
- [ponytail](https://affpapa.org/en/nevibecode/plugins/ponytail.md) — plugin · ★ 176443
- [impeccable](https://affpapa.org/en/nevibecode/plugins/impeccable.md) — plugin · ★ 88212
- [last-30-days-skill](https://affpapa.org/en/nevibecode/plugins/last-30-days-skill.md) — plugin · ★ 65508
- [claude-hud](https://affpapa.org/en/nevibecode/plugins/claude-hud.md) — plugin · ★ 28841
- [understand-anything](https://affpapa.org/en/nevibecode/plugins/understand-anything.md) — plugin · ★ 88314
- [mem0](https://affpapa.org/en/nevibecode/plugins/mem0.md) — plugin · ★ 67829

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md