AI Tool Atlas
Usage tracker

CAP (Claude Allowance Pulse)

Lightweight, zero-dependency Claude Code statusline plugin showing usage limits, context window, session cost and update alerts.

Author
PeterCha90
Works with
Claude Code
License
MIT
Documented
Oct 28, 2026
Repository ↗ Official docs ↗

What CAP (Claude Allowance Pulse) is

CAP is a small statusline plugin for Claude Code. It shows the usage limits, context window usage, session cost and update alerts, with no dependencies. Usage data needs the Claude Code OAuth token; responses are cached for 60 seconds by default, which the README suggests raising to 120 seconds if you hit 429 rate limits.

What it does

How CAP (Claude Allowance Pulse) plugs in: which agents run it and what it addsRUNS INYour agentClaude Codeone host documentedTRACKERCAP (Claude Allowance Pulse)Shows how much of a plan's usage…3 install steps1 permission notelicense: MITWHAT IT ADDSWhat it doesUsage limits with green, yellow a…Context window usage and session…Update alerts for the plugin itse…agent → extension → new capability · from the official repository or docs
Where CAP (Claude Allowance Pulse) runs and what it adds, from its documentation
  • Usage limits with green, yellow and red thresholds at 50, 70 and 85 percent
  • Context window usage and session cost
  • Update alerts for the plugin itself

When to use it

Good fit

  • You want a minimal status line and do not need Claude HUD's extra panels

Not for

  • Sessions without a Claude Code OAuth token

How to install CAP (Claude Allowance Pulse)

You need: Claude Code with an OAuth login

Install in one click

Paste the copied command into the Claude Code terminal and confirm the prompt.

  1. In Claude Code: /plugin marketplace add PeterCha90/CAP
  2. /plugin install cap
  3. Run /cap:setup, or /reload-plugins, or restart Claude Code

Permissions and security

What it can access

  • Reads the Claude Code OAuth token to query the usage API

Review the source before granting an agent access to credentials or production systems. We document what the maintainers state; we do not audit code.

Limitations

  • Settings are edited in scripts/usage-hud.mjs (USAGE_TTL, UPDATE_TTL, colour thresholds)

Tools it extends

Frequently asked questions

What if CAP hits 429 rate limits?

The README says to raise USAGE_TTL from 60000 to 120000 milliseconds so the usage API is polled less often.

How do I check that the OAuth token CAP needs exists?

The README's troubleshooting table suggests security find-generic-password -s "Claude Code-credentials" -w in the macOS terminal.

How often does CAP check for updates?

Every six hours by default (UPDATE_TTL 21600000 milliseconds), editable in scripts/usage-hud.mjs.

Sources and gaps