jonathanlocks

Usage Band Mod — AI skill for Claude Code

AI community

Claude Code mod: a live usage band above the prompt with context window, 5-hour, weekly and per-model limits and session cost.

How to install Usage Band Mod

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

What Usage Band Mod does

Claude Code mod: a live usage band above the prompt with context window, 5-hour, weekly and per-model limits and session cost. Native macOS settings window.

Alternatives in AI

  • Claude Usage Tracker — Native macOS menu bar app for tracking Claude AI usage limits in real-time 2.2k ★
  • Usage — macOS menu bar & Windows tray app pinning Claude Code, Codex & Antigravity quota, burn rate, and cost to your 301 ★
  • TokenEater — 179 Native macOS menu bar app for monitoring Claude AI usage limits and watching coding sessions live 196 ★

README

Animated pixel crab mascot

Usage Band

**A Claude Code mod that keeps your limits in sight: context window, 5-hour session, week and per-model usage, in one line above the prompt.**

[![GitHub stars](https://img.shields.io/github/stars/jonathanlocks/usage-band-mod?style=flat&logo=github)](https://github.com/jonathanlocks/usage-band-mod/stargazers) [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![Claude Code mod](https://img.shields.io/badge/Claude%20Code-mod-D87656)](https://docs.claude.com/en/docs/claude-code) [![macOS 26](https://img.shields.io/badge/settings%20window-macOS%2026-black?logo=apple)](#settings-window-macos)

[Install](#install) · [What it shows](#what-it-shows) · [Meet the mascot](#meet-the-mascot) · [What leaves your machine](#what-leaves-your-machine) · [Settings window](#settings-window-macos)


Claude Code in a terminal. Above the prompt box, one line reads: Opus 5.5, $34.63, Context 56%, 5h 25%, 7d 4%, Fable 2%

In the terminal: drawn from the band's real output at 110 columns.



The band in the Claude desktop app: pixel crab, Opus 5.5, cost in reais, and bars for context 56%, 5h 25%, 7d 4% and Fable 2%

In the Claude desktop app.


**Status:** early release (0.2.0), maintained by one person. Tested on macOS 26.6 with Claude Code 2.1.302, in the terminal and in the desktop app. The band works anywhere Claude Code runs; the settings window needs macOS 26.

What it shows

  • Model and session cost. The cost is what the session would cost at API prices. On a Pro or Max subscription it is an equivalent, not a charge. Show it in US dollars, Brazilian reais or euros Converted values use market rates, not what your card charges.
  • Context window used by the current session