A comprehensive statusline dashboard for Claude Code with session summary, quota bars, agent tracker, MCP health, message history sidebar, and more.

version
1.0.0
GitHub stars
264

Install

/plugin install cc-statusline@cc-statusline

Run it inside Claude Code after adding the marketplace with /plugin marketplace add NYCU-Chung/cc-statusline.

Contents

Discovered from source

Commands 1

cc-statusline :: row configuration

Manage cc-statusline. Config lives at ~/.claude/cc-statusline-rows.json; statusline.js reads it on every render.

A top-level enabled flag acts as the master switch β€” when enabled: false, the statusline prints nothing at all. Individual row flags control which sections appear when the statusline IS enabled.

Special configuration options

Besides row toggles the file also holds non-row behaviour knobs:

keytypedefaultdescription
enabledbooleantrueMaster switch β€” false = no output at all
summaryIntervalnumber10How many UserPromptSubmit events between session-summary nudges (minimum 1)
aggWindowDaysnumber0Rolling window (in days) for the all-session cost + tokens aggregate. Default 0 = all time. Set to 7 / 30 / 90 etc. for a rolling view.
statuslineWidthnumber(auto)Hard-set the box width in columns. Width auto-detection is unreliable inside the statusline hook (see #5430) β€” Claude Code doesn't pass the available width and most fallbacks return wrong values. Measure your terminal once (tput cols from a normal shell) and set it here. Default fallback is 120.
statuslineWidthOffsetnumber4Columns reserved on the right after statuslineWidth is resolved, to leave room for Claude Code's own padding/indicator. Increase if the box still gets truncated; decrease to 0 if your terminal renders edge-to-edge.

Valid row keys

keywhat it controls
summaryTop session-summary row (auto-written by Claude)
dirπŸ“ directory + +added -removed lines
repoowner/repo branch (N changed) row
modelModel name + effort level
durationActive session time (sum of turn durations from UserPromptSubmit β†’ Stop, idle outside turns naturally excluded). Shares the model row area visually but toggles independently.
costcost $TOTAL (<window>) Β· $SESSION (this session) β€” window label reflects aggWindowDays
usagetokens ... context ... compact ... row
quota5h-quota + 7d-quota row with countdowns
agentsSubagent activity row
memory_mcpCombined memory β”‚ mcp row
editedRecently edited files row
historyRight-side message history column

User input

$ARGUMENTS

What to do

  1. Read ~/.claude/cc-statusline-rows.json. If it doesn't exist, treat enabled as true, every row as true, summaryInterval as 10, aggWindowDays as 0 (all time), statuslineWidth as unset (auto-detect with fallback 120), and statuslineWidthOffset as 4.
  2. Parse user input from above:
    • No args β†’ just list current state (step 4, no write).
    • off (no rows listed) β†’ set enabled: false (master switch off). Keep row flags intact.
    • on (no rows listed) β†’ set enabled: true. Keep row flags intact.
    • reset β†’ set enabled: true, every row key to true, and remove every special-options key (summaryInterval, aggWindowDays, statuslineWidth, statuslineWidthOffset) so each falls back to its default.
    • summary-interval <N> β†’ set summaryInterval: N. Reject N < 1.
    • agg-window <N> β†’ set aggWindowDays: N. Accept 0 (all time). Reject negative.
    • only <rows...> β†’ every listed row becomes true, every other row becomes false. Leave special options untouched.
    • hide <rows...> β†’ every listed row becomes false. Others unchanged.
    • show <rows...> β†’ every listed row becomes true. Others unchanged.
    • toggle <rows...> β†’ flip each listed row's current value.
    • Accept row names comma/space separated, case-insensitive. Reject unknown keys with a message but still proceed with valid ones.
  3. Write the merged config back to the same file using the Write tool (pretty-printed JSON: enabled first, then special options, then row keys in the canonical order shown in the table above).
  4. Print a short table of the resulting state β€” one line per key like:
  summary     βœ“ shown
  dir         βœ“ shown
  repo        βœ— hidden
  ...

Use βœ“ and βœ— with colors (green / dim red) if your output renders them. Keep the reply concise β€” no more than the table plus one short confirmation sentence. Do not open the file, do not paste the JSON, do not run statusline.js.

Sponsors

Details

Marketplace
NYCU-Chung/cc-statusline
Author
NYCU-Chung
Category
Community