anantraghunath

Claude Code Usage Quota Mod — Development skill for Claude Code

Development community

Know your Claude limits before they hit you (Live band above the Claude Code prompt): 5 Hour and Weekly usage (whole account) with a live usage forecast against limit resets, context window usage, one.

How to install Claude Code Usage Quota Mod

This entry records only its repository, not the path inside it, so there is no exact command to give. Open anantraghunath/claude-code-usage-quota-mod and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Code Usage Quota Mod does

Know your Claude limits before they hit you (Live band above the Claude Code prompt): 5 Hour and Weekly usage (whole account) with a live usage forecast against limit resets, context window usage, one-click Compact and per-session Auto compact (30% default).

Alternatives in Development

  • Claude Usage Monitor — Claude Code statusline plugin for 5-hour/7-day quota, context usage, tokens, and reset countdowns in your term 51 ★
  • Brow — Claude Code usage and rate limits in the MacBook notch 50 ★
  • Claudetuner — Know when you'll hit your Claude, ChatGPT & Gemini usage limits — live 5h/weekly gauges, reset forecasts, and 34 ★

README

Claude Code Usage Quota Mod with Auto Compact

[![Version: v0.1.3](docs/badges/version-v0.1.3.svg)](https://github.com/anantraghunath/claude-code-usage-quota-mod/releases/latest) ![Auto compact: 30% default](docs/badges/auto-compact-v2.svg) ![Compact: one click](docs/badges/compact-v2.svg) ![5 Hour + Weekly: whole account](docs/badges/limits-v2.svg) ![Forecast: before reset](docs/badges/forecast-v2.svg) ![Works in: Desktop + Terminal](docs/badges/works-in-v2.svg) ![License: MIT](docs/badges/license-v2.svg)

**Know your Claude limits before they hit you.** A live band above the Claude Code prompt that shows your plan limits, forecasts whether you'll run out before they reset, and shows how full your context window is. **Compact in one click, or let it compact automatically.**

The 5 Hour and Weekly limits are **your whole Claude account's**, including what you use in Claude chat and Cowork. The band itself shows in **Claude Code**: the desktop app and the terminal.

Type **`/quota`** to turn the band off and on.

Expanded

![The band, expanded, above the prompt in the Claude desktop app](docs/expanded-desktop.png)

Collapsed

One row that still shows the time left until each limit resets:

![The band, collapsed, above the prompt in the Claude desktop app](docs/collapsed-desktop.png)

[!TIP] **Never hit a full context again: Auto compact, on by one click.** With Auto compact on, the band compacts your session once the context reaches **30%** (the default; set **15 to 99**). A long context costs more on every reply, so compacting early keeps replies **cheaper** and your limits **lasting longer**. Auto compact never interrupts a reply. Want to compact right now? The **Compact** button runs `/compact` in one click.

**Each session keeps its own Auto compact setting**, even after a restart, so you can run them differently side by side:

  • Building something big? Set Auto compact higher (say 70%) or turn it off, so Claude keeps the whole picture. Pres