Sub Meter

See Claude Code usage limits in the footer

·

source at 249f0f6

·

MIT license

A meter at the bottom right of Claude Code, on the permission mode line, showing how much of your 5-hour and weekly subscription windows you've used and when each resets.

What this mod can do

  • Reviewed at commit 249f0f6
3 things it can do
  • Remembers data between sessions
  • Runs on a timer
  • Runs on Claude Code hooks, such as session start
Good to know (3)
  • Needs a subscription: with API key billing there is nothing to show and the footer stays as it is.
  • Usage on claude.ai or the mobile app shows up only after the next Claude Code response.
  • Set display in /config to both, session or week to stop it switching between windows.
Are mods safe?

Preview

Terminal

⏵⏵ auto mode on · ← for agents 5h ━━━─────── 26% ↻ 2h 7m

Claude Desktop

Sub Meter in Claude Desktop

What it does

In the author's words

Your subscription usage at the bottom right of Claude Code: the 5-hour and weekly windows, taking turns, side by side or fixed on one of them.

What you see
A usage bar at the bottom right, beside the mode
Works in
Terminal and Claude Desktop
Slash commands
None
Uses your tokens
No
Changes files
Nothing
Network access
None
Reviewed commit
249f0f6
Preview recorded with
Claude Code 2.1.309

How it works

  1. Takes a first reading at session start, or shows the last one saved
  2. After each response, reads the five_hour and seven_day rate-limit windows
  3. Draws a bar, percent and reset time beside the mode, switching windows every 8 seconds
  4. Drops the (shift+tab to cycle) and esc to interrupt hints to make room

Common questions

How do I see my Claude Code 5-hour usage limit?

This mod shows the 5-hour window as a bar with a percent and the time until it resets, at the bottom right of Claude Code. The bar turns yellow from 75% and red from 90%.

Does Claude Code report a monthly usage window?

No. The README says Claude Code only reports the 5-hour and weekly windows, so there is no monthly one to show.

Can I show the 5-hour and weekly windows at the same time?

Yes. Set display to both in /config to show them side by side, separated by |. The default, rotate, switches every 8 seconds, which rotateSeconds changes.

Badge for your README

Own this listing? Add it to your README. The badge shows the install count as it grows.

Reviewed on statuslin.es
[![Reviewed on statuslin.es](https://staging.statuslin.es/badge/mods/sub-meter.svg)](https://staging.statuslin.es/mods/sub-meter?utm_source=readme-badge)

Or show the preview card:

Preview on statuslin.es
[![Preview on statuslin.es](https://staging.statuslin.es/og/mods/sub-meter.png)](https://staging.statuslin.es/mods/sub-meter?utm_source=readme-badge)

More like this

Context Meter in Claude Desktop

The session's context window fill, right above the prompt: gray while there is room, yellow when it is time to /compact, red when a new session is better.

Deck in Claude Desktop

A cockpit for Claude Code: plan bars and subagent strips, context, usage limits with reset countdowns and burn rates, spend, the model route and a pet. Six bar styles, three collapsed looks. CLI and Desktop.

Flightdeck in Claude Desktop

Flightdeck: a live agent dashboard for Claude Code. Main model vitals, an on-call architect, every permission check, subagent cards and swimlanes, a turn receipt and a session log, all from real session events

Opus 4.8 ▓▓░░░░░░░░ 22%

Model plus a 10-block context-usage bar. Example statusline inspired by the Claude Code docs (code.claude.com/docs/en/statusline).

Opus 4.8 high ✦ │ ctx 22% │ app (main) │ PR #1287 ● │ $0.41 · 10m +128 -34 Session ● ● ● ● ● ● ● ● ○ ○ ○ 74% left Resets in 2h 6m Weekly ● ● ● ● ● ● ● ● ● ● ○ 93% left Resets in 2d 0h

Feature-rich bash status line with model, context bar, session cost (read live from Claude Code, so it stays correct on any model), rate-limit bars, and live tool/agent activity that adapts to terminal width. Source: github.com/JungHoonGhae/claude-statusline

✧ ███████████▋ 73% 🗝 Ultima Weapon ✦ app ∙ main ♥ ████████████████████████ 100% 「SAVE POINT」 ✶ Limit Form ◉ 41

Claude Code plan-usage HP bar that reads the Claude auth token to show remaining usage.

app · main · Opus-4.8 · effort high · ctx 22% · 5h 26% ↻2h6m · 7d 7% ↻2d0h

Folder, git branch, model (color-coded by family), effort, context usage, and 5h/7d rate-limit usage with reset countdowns — all on one line, each percentage going green → yellow → red as it climbs. Needs jq.