better-statusline draws your Claude Code session as dot-matrix rings so you can see context, cache and rate limits without a command

A Claude Code user who hits their weekly allowance in the middle of a task has already paid the cost.

better-statusline, published on GitHub on 5 October 2026 by Autumn1337, is a Claude Code plugin that renders the session's figures as dot-matrix rings above the prompt. It reads the context window usage, how much of the prompt cache is left before it expires, and the 5-hour and weekly rate limits, then draws each one as a ring made from braille dots. It needs Claude Code 2.1.289 or later and is MIT licensed.

What the status line shows

The rings sit on one terminal line and each one tracks a different number: how full the context window is, how long the prompt cache has to live, how far through the 5-hour allowance the account is, and how much of the weekly limit is still available. The display also prints the current model and reasoning effort, the Git branch with staged and modified files, which subagents are active, and the per-turn and cumulative token spending.

The repository's README says the whole thing is intended to use about three to four percent of the CPU while animating, so it does not interfere with the main session.

The macOS music card is an aside

The author also added a card that shows the Spotify or Apple Music track playing beside the usage figures on macOS, with controls for kitty 0.28 or Ghostty terminals that support album art. The author describes it as a feature that was fun to build. It is not the reason to install the plugin.

What it needs to run

The plugin ships as a Claude Code marketplace install or a local directory, so a user does not have to clone anything to try it. It depends on git, Python 3 for the rounded rings at specific font sizes, and a Nerd Font for the music card icons. A /fold command collapses the display when the user wants the terminal back. The colour scheme reads Claude Code's own theme so the status line matches the rest of the interface.

The traction

The repository went to 120 stars in under a day on GitHub, which the project's creation date confirms: created on 5 October 2026 at 08:44 UTC and already picked up by the trending list the same day. Taste matters here more than the count, because a plugin that shows the number before it hits zero is cheaper than finding out from an error message that the session has stopped. Anthropic has not published a target for how often users exhaust the weekly allowance, so there is no vendor figure to compare the plugin's utility against.

The plugin only reads information Claude Code already prints: the session file, usage endpoints and Git state. It does not change anything in the IDE or shell beyond the one status line. A user who wants their terminal back deletes the plugin, which is the same cost as installing it.

Source

• Repository: Autumn1337/better-statusline on GitHub