Skip to content

Statusline

A four-row panel at the bottom of every imp session (the terminal session imprnt launches). A long session loses track of where it stands, and the status line keeps the numbers that matter in front of you.

How it works

A harness plugin, one that dresses up the session itself and never touches your notes. It draws four aligned rows, and each row reads left to right as a label and its segments.

RowWhat it shows
model Which model is running, the session name, the working folder, and where your git branch stands.
cost Spend so far, elapsed time, and lines added and removed this session.
ctx A gauge of the context window (the assistant's working memory), its fill percent, and the effort level.
limits How much of the 5-hour and 7-day usage limits is burned and when each resets, your vault note and review counts, the weather, and the clock.

Color is a single alarm ramp. Every percentage and the gauge show green below 60, turn amber past 60, and go red past 85, so a quiet session reads all green and amber is news.

green 0 to 60% amber past 60% red past 85%

On a narrow terminal each row drops segments in a fixed order rather than wrapping. There is no command to run. Claude Code pipes session data to the script and the script prints the line.

make it yours

The line is whatever plugins/statusline/statusline.js prints, so you can edit the segments. To keep the default pristine, copy the plugin into plugins/_personal/ and wire your copy instead.

Install

This copies the plugin into plugins/statusline/ and wires it. imp forwards the statusLine setting to every claude session it launches, so nothing is written into your Claude settings and plain claude stays untouched. (The gemini backend has no statusline host, so imp skips it there with a warning.) Adding --purge to the remove command deletes the folder too.