Claude Code status line

ClaudeStatsBar

A Claude Code status line showing how big your session has got and what the next turn costs before you type

30 stars 2 forksStatus lines Source

Install

From source
git clone https://github.com/Field-Logic-Ltd/ClaudeStatsBar.git

From the README

ClaudeStatsBar: your session is 486k deep and nothing told you what that costs

A Claude Code status line for the number that actually bites. Not how full the
context window is - Claude Code will tell you that in one command - but what the
next turn costs before you type a word, and when it is worth clearing rather
than finding the limit mid-task.

Pure Python stdlib. No dependencies, no network, no transcript parsing, no proxy.
~25ms per render.

Why this exists

Building anything large with Claude means long sessions, and the session grows
underneath you whilst you work. By default nothing warns you what that is
costing, so the first sign is usually the limit itself - context exhausted, or
the rolling usage window gone, mid-task. The stronger the model the sooner that bites; Fable on a
big codebase will find the ceiling well before you expect it to.

This puts the size on screen whilst you work: how much context the session is
carrying, what the next turn costs before you type a word, and how much of the
5h and 7d windows is left. Enough to clear at a sensible boundary instead of
discovering the limit halfway through a refactor.

Sessions get far bigger than they feel. I measured two weeks of my own Claude
Code usage - 916 transcripts, 711 sessions, 57,451 API requests, 11.6 billion
tokens - and the sizes were not what I expected.

Everything I typed across 711 sessions was 1.3M tokens. The same sample re-read
11.1 billion tokens of context it was already carrying. Shorter prompts are
not the lever; session size is.

The reason is that the API is stateless. Every turn re-sends the entire
conversation - system prompt, instructions, and all prior turns - so what goes
on the wire grows with every message, whether you typed a paragraph or "yes".

Why it…
Read the full README on GitHub

How status lines work

  • A status line is a command Claude Code runs to draw the bar under the prompt. It gets the session as JSON on stdin (model, folder, cost, context) and prints one or more lines.
  • Point the statusLine setting in ~/.claude/settings.json at it: { "statusLine": { "type": "command", "command": "<the command from the README>" } }.
  • Or run /statusline inside Claude Code and describe what you want.
Claude Code docs

Details

Language
Python
License
MIT
Last updated
11 September 2026

FAQ

What is ClaudeStatsBar?

A Claude Code status line showing how big your session has got and what the next turn costs before you type It is a status line for Claude Code, from Field-Logic-Ltd/ClaudeStatsBar on GitHub.

How do I install ClaudeStatsBar?

Clone Field-Logic-Ltd/ClaudeStatsBar from GitHub and follow the setup steps in its README.

Is ClaudeStatsBar popular?

Field-Logic-Ltd/ClaudeStatsBar has 30 GitHub stars and 2 forks. It was last updated on 11 September 2026.

More status lines

Browse the most popular Claude Code mods, all status lines, or the skills and MCP server directories.