
cc-statusline
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-statuslineRun it inside Claude Code after adding the marketplace with /plugin marketplace add NYCU-Chung/cc-statusline.
Contents
Discovered from sourceCommands 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:
| key | type | default | description |
|---|---|---|---|
enabled | boolean | true | Master switch β false = no output at all |
summaryInterval | number | 10 | How many UserPromptSubmit events between session-summary nudges (minimum 1) |
aggWindowDays | number | 0 | Rolling window (in days) for the all-session cost + tokens aggregate. Default 0 = all time. Set to 7 / 30 / 90 etc. for a rolling view. |
statuslineWidth | number | (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. |
statuslineWidthOffset | number | 4 | Columns 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
| key | what it controls |
|---|---|
summary | Top session-summary row (auto-written by Claude) |
dir | π directory + +added -removed lines |
repo | owner/repo branch (N changed) row |
model | Model name + effort level |
duration | Active session time (sum of turn durations from UserPromptSubmit β Stop, idle outside turns naturally excluded). Shares the model row area visually but toggles independently. |
cost | cost $TOTAL (<window>) Β· $SESSION (this session) β window label reflects aggWindowDays |
usage | tokens ... context ... compact ... row |
quota | 5h-quota + 7d-quota row with countdowns |
agents | Subagent activity row |
memory_mcp | Combined memory β mcp row |
edited | Recently edited files row |
history | Right-side message history column |
User input
$ARGUMENTS
What to do
- Read
~/.claude/cc-statusline-rows.json. If it doesn't exist, treatenabledastrue, every row astrue,summaryIntervalas10,aggWindowDaysas0(all time),statuslineWidthas unset (auto-detect with fallback120), andstatuslineWidthOffsetas4. - Parse user input from above:
- No args β just list current state (step 4, no write).
off(no rows listed) β setenabled: false(master switch off). Keep row flags intact.on(no rows listed) β setenabled: true. Keep row flags intact.resetβ setenabled: true, every row key totrue, and remove every special-options key (summaryInterval,aggWindowDays,statuslineWidth,statuslineWidthOffset) so each falls back to its default.summary-interval <N>β setsummaryInterval: N. RejectN < 1.agg-window <N>β setaggWindowDays: N. Accept0(all time). Reject negative.only <rows...>β every listed row becomestrue, every other row becomesfalse. Leave special options untouched.hide <rows...>β every listed row becomesfalse. Others unchanged.show <rows...>β every listed row becomestrue. 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.
- Write the merged config back to the same file using the Write tool (pretty-printed JSON:
enabledfirst, then special options, then row keys in the canonical order shown in the table above). - 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