better-statusline

better-statusline

  A status line for Claude Code, drawn above the prompt:
  the session's figures as dot-matrix rings, and the music you are playing beside them.

  The film ·
  What it shows ·
  Install ·
  Options

The film

    Fifty-two seconds. All of it is drawn in code: the picture, the two covers and the score.
    With sound:
    1080p ·
    4K

What it shows

Drawn in dots

A braille cell is eight dots. Every drawing here is made of them: a ring is a true circle, found on the screen and snapped dot by dot to the terminal's grid.

Rings

Each ring is lit clockwise from its top, with its figure at its heart.

- Context: how full the window is.
- Cache: the minutes left before the prompt cache goes cold, counted from the last response. An hour on a subscription inside its limits, five minutes otherwise.
- 5-hour and weekly: how much of each limit is spent, and when it starts over. The arc turns yellow once you spend faster than the window passes.

Above them, a header names the model and its effort, the folder, the git branch with its staged and modified files, the lines the session added and removed, and the subagents at work.

Spend

One bar for each recent turn, beside the session's total. The bars grow by the square root of the cost, so one dear turn leaves the rest standing.

Music

On macOS a card shows what Spotify or Apple Music is playing, in an accent read out of the cover. It takes the mouse: play, pause, skip, seek along the line, shuffle, repeat, and the volume at the right end of the controls.

The band

/fold folds the whole band into one row, and opens it again. The colours are Claude Code's own theme, so the band follows it from dark to light.

Requirements

Each missing piece takes only its own part away: without a player the band is the…