NYCU-Chung/cc-statusline

README preview

# cc-statusline

**English · [繁體中文](./README.zh-TW.md)**

A comprehensive statusline dashboard for Claude Code. See everything at a glance — no slash commands needed.

![Demo](./images/demo-en.png)

## What it shows

| Section | Info |
|---------|------|
| **session summary** | Auto-generated whole-session summary (Claude rewrites it every ~10 messages with built-in compression so it stays under ~120 chars) |
| **directory** | Current working directory + `+added -removed lines` |
| **repo + branch** | `owner/repo` (parsed from `git remote`) + branch + `(N changed)` |
| **cost** | `cost $TOTAL (<window>) · $SESSION (this session)` — all-session spend rendered as parallel parenthetical annotations. Window defaults to all time; set `aggWindowDays` in `~/.claude/cc-statusline-rows.json` for a rolling view (e.g. `7` / `30` / `90`). |
| **model** | Active model name + effort level with 5-tier color ladder (`low` dim / `medium` green / `high` yellow / `xhigh` orange / `max` red) |
| **duration** | Active session time — sum of every turn's wall-clock duration (UserPromptSubmit → Stop). Inter-turn idle is naturally excluded, no idle threshold needed. Shares the model row area visually but toggles independently (`/cc-statusline:rows hide duration`). |
| **tokens / context / compact** | `tokens TOTAL (SESSION this session)` (same all+session dual display as cost) · context window % · compact count (`compact 1 time` / `compact N times`) |
| **5h-quota** | Color-coded bar (green → yellow → red) + auto-rolling `resets Xh Ym` countdown. Auto-zeros when `resets_at` passes real-world time (payload is stale until next message). |

View full repository on GitHub →