claude-statusline

Claude Code Statusline

Compact, colorful status line for Claude Code CLI with 21 themes, real-time rate limits, context usage, cost tracking and git info.

Works on macOS, Linux, and Windows!

Features

- 21 Themes — from Kratos to Spiderman, switch with /skin command
- Rate limits — 5-hour and 7-day usage with progress bars + time until reset
- Context usage — real-time token consumption with color-coded alerts
- Cost & Time — session cost in USD and total time
- Git info — branch name, uncommitted changes count
- Lines changed — added/removed lines counter

Install

macOS / Linux

Windows (PowerShell)

Press Shift+Tab to see the statusline!

Themes

21 themes available. Use /skin to see gallery or /skin  to apply.

Press Shift+Tab to refresh statusline after changing skin.

Usage

Reading the statusline

The statusline displays three rows of information:

Row 1 — Model, directory, git branch, changes count, lines added/removed
Row 2 — Context usage, session cost in USD, session time
Row 3 — 5-hour rate limit with reset time, weekly rate limit with reset time

Status indicators

Color warnings

Progress bars change color based on usage:
- Normal color — under 70%, plenty of capacity
- Yellow/Warning — 70-89%, approaching limit
- Red/Critical — 90%+, limit almost reached

Changing themes

After applying a theme, press Shift+Tab to refresh the statusline.

Folder skins are stored in ~/.claude/skin_dirs ( per line) and override the global skin; the most specific matching folder wins.

Uninstall

macOS / Linux

Windows (PowerShell)

Requirements

macOS / Linux
- jq — JSON processor (brew install jq)
- git — for repository info

Windows
- Python 3.8+ (from python.org or Microsoft Store)
- git — for repository info
- keyring package (optional, for rate limits): pip install…