jack21

Claude Mod Usage — Development skill for Claude Code

Development community

Claude Code Mod: context, 5-hour and 7-day usage as gradient progress bars above the prompt.

How to install Claude Mod Usage

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

What Claude Mod Usage does

Claude Code Mod: context, 5-hour and 7-day usage as gradient progress bars above the prompt. 12 languages.

Alternatives in Development

  • Claude Warmup — Manipulate Claude Code's 5-hour usage window into resetting when you actually need it 127 ★
  • 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 ★

README

claude-mod-usage

**English** · [简体中文](docs/README.zh-CN.md) · [繁體中文](docs/README.zh-TW.md) · [日本語](docs/README.ja.md) · [हिन्दी](docs/README.hi.md) · [Español](docs/README.es.md) · [العربية](docs/README.ar.md) · [Français](docs/README.fr.md) · [বাংলা](docs/README.bn.md) · [Português](docs/README.pt.md) · [Русский](docs/README.ru.md) · [Bahasa Indonesia](docs/README.id.md)

A Claude Code Mod that shows your Claude usage as three gradient progress bars right above the prompt in **Claude Code Desktop** (also VS Code and the mobile app):

  • Context: how full the current context window is
  • 5-hour limit: your session usage, with the time left until it resets
  • 7-day limit: your weekly usage, with the time left until it resets

![claude-mod-usage preview](assets/preview.png)

Features

  • Green → yellow → red gradient bars with rounded ends; the icon's accent colour follows the usage too
  • The percentage sits in the middle of each bar, outlined so it stays readable on any colour
  • All bars have the same length and the row always uses the full width
  • Reset countdown in a monospace font
  • Updates after every turn and whenever a limit moves by a whole point; the countdown ticks every minute
  • 12 languages, detected automatically
  • Leaves the terminal alone: the CLI already has a status line for this
  • Plays well with other mods above the prompt: whatever they draw there is stacked under the bars instead of being covered

![All 12 languages](assets/languages.png)

Requirements

  • Claude Code with Mods (function hooks) support. Tested on 2.1.286. The Mods API is in early access and may change.
  • A Claude subscription. The 5-hour and 7-day bars only appear when Claude Code reports rate limits; with an API key you get the context bar alone.

Install

Quick install: let Claude do it

Copy this prompt and paste it into Claude Code (Desktop, CLI or VS Code). Claude clones the mod, updates your settings and checks them:

Install the claude-mod-usa