Token Meter

See how many tokens each Claude Code turn uses

·

source at 249f0f6

·

MIT license

After each turn, the hint line under the prompt ends with that turn's input, output and cache tokens and the session's running total, in color.

What this mod can do

  • Reviewed at commit 249f0f6
Good to know (2)
  • The session total starts over whenever a new session starts.
  • It draws in the hint line, not the status line, because the status line only takes plain text.
Are mods safe?

Preview

Terminal

· ↑ 37.0k ↓ 1.4k cache 7.0k · session ↑ 111.0k ↓ 4.2k

Claude Desktop

Draws nothing in Claude Desktop.

What it does

In the author's words

Each turn's tokens and the session's running total, in color at the end of the hint line under the prompt.

What you see
Colored token counts at the end of the hint line
Works in
Terminal
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. Runs when each turn in the session completes
  2. Reads the turn's token usage and adds it to the session total
  3. Appends the colored meter after what the hint line already shows

Common questions

How do I see how many tokens each Claude Code turn uses?

This mod adds the last turn's tokens to the hint line under the prompt: ↑ input in blue, ↓ output in green and cache for tokens read from or written to the prompt cache, followed by the session's running total, dimmed.

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/token-meter.svg)](https://staging.statuslin.es/mods/token-meter?utm_source=readme-badge)

Or show the preview card:

Preview on statuslin.es
[![Preview on statuslin.es](https://staging.statuslin.es/og/mods/token-meter.png)](https://staging.statuslin.es/mods/token-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.

Context Bar in Claude Desktop

Your context window as a stacked bar above the prompt, a color per category, with token counts and the compaction point. /context-bar shows or hides it.

⎿ cache-tax: keepwarm on for 6h00m, a ping 50m after each idle stretch keeps the cache read, not re-written ⎿ cache-tax: claude-opus-5-5 state warm, 1h00m left context 44,000 tokens cold cost $0.35 to re-write it (warm turn $0.01) keepwarm on, 6h00m left · ping in 50m break-even up to 40 pings at the read rate cost one cold write, about 33h20m of idle at one ping per 50m guard ask first (/cache-tax guard warn to only show the price) session 0 cold writes paid, $0.00 [>] cache-tax · warm · keepwarm 6h00m left · ping in 50m [-]

A Claude Code mod that keeps the one-hour prompt cache warm during breaks and asks before a cold send, showing its estimated rewrite cost. Warming uses model requests and costs tokens. Requires Claude Code 2.1.287+.

⎿ context-inspector: Context Inspector pane opened (shown in the terminal and the desktop app). ╭────────────────────────────────────────────────────────────────────────────────────────────────✕─╮ │ Context Inspector — main context │ │ Live ≈3.0k tokens in 12 items · 1 turn(s) · 0 compaction(s) · waste ≈0 │ │ ≈ = estimate (chars/4 × k=1.00, 0 calibration segment(s)); figures without ≈ are measured or en… │ │ │ │ Top occupants (live, by category) │ │ attachment:skill_listing ≈1.5k 50% █████░░░░░ 1 item(s) │ │ attachment:agent_listing_de… ≈685 23% ██░░░░░░░░ 1 item(s) │ │ attachment:environment ≈180 6% █░░░░░░░░░ 1 item(s) │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯ ⚠ context-inspector: ctx 22% · waste≈0

Context waste analyzer for Claude Code: what fills the window, re-reads, near-duplicate outputs, what compaction kept, advice

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.