Minimal Claude Code statusline with usage limits and budget tracking
npm install @daliovic/cc-statuslineA minimal, informative statusline for Claude Code CLI.
```
š¤ Opus ā š 53% 106K ā ā± 26% 2h09 ā¼1h32/46% 2d15 ā¼1d04 ā š Asr 15:32 (2h15) ā š 3
- Model indicator - Shows current model (Opus, Sonnet, Haiku)
- Context usage - Percentage + token count (turns orange at 75%)
- Usage limits - 5-hour session and 7-day limits with reset times
- Budget delta - Shows if you're under (ā¼ green) or over (ā² red) your expected usage rate
- Prayer times - Next prayer name, time, and countdown (auto-detects location)
- MCP servers - Shows count of enabled MCP servers for the current session
- Customizable - Interactive wizard to configure colors, visibility, and thresholds
`bash`
npm install -g @daliovic/cc-statusline
`bash`
git clone https://github.com/daliovic/cc-statusline.git
cd cc-statusline
npm install
npm run build
Add to ~/.claude/settings.json:
`json`
{
"statusLine": {
"type": "command",
"command": "cc-statusline",
"padding": 0
}
}
Or if installed from source:
`json`
{
"statusLine": {
"type": "command",
"command": "node /path/to/cc-statusline/dist/statusline.js",
"padding": 0
}
}
Run the interactive configuration wizard:
`bash`
cc-statusline --config
This lets you customize:
- Visibility - Show/hide model, context, 5hr limit, 7day limit, delta arrows, prayer times, MCP servers
- Colors - ANSI 256 color codes for each element
- Thresholds - Context warning percentage, cache TTL
- MCP display - Show server count or names
Config is saved to ~/.claude/cc-statusline.json.
Prayer times are enabled by default and auto-detect your location via IP. Configure via --config:
- Calculation method - 20+ methods including Umm Al-Qura, ISNA, Muslim World League, and regional options
- Location - Auto-detect via IP, city/country search, or manual coordinates
See Aladhan API docs for all available calculation methods.
Shows the count of enabled MCP servers for your current project. Configure via --config:
- Display mode - Show server count (š 3) or names (š reddit, chrome, shell)š reddit, chrome+1
- Max names - Limit names shown before truncating (e.g., )
Reads from ~/.claude.json and respects both global and project-level disabledMcpServers.
| Variable | Default | Description |
|----------|---------|-------------|
| STATUSLINE_CACHE_TTL_MS | config value | API cache duration (overrides config) |
- Reads session data from Claude Code via stdin
- Calculates context usage from transcript file
- Fetches usage limits from Anthropic OAuth API (cached)
- Budget delta shows time ahead/behind ideal linear usage
``
š¤ Model ā š Context% Tokens ā ā± 5hr% Time Delta/7day% Time Delta ā š Prayer Time (countdown) ā š MCP
Default Colors (customizable via --config`):
- Cyan: Model name and icons
- Gray: Percentages and times
- Orange: Context at threshold
- Green ā¼: Under budget
- Red ā²: Over budget
- Purple: MCP servers
MIT License - Do whatever you want with this. Attribution appreciated but not required.
Inspired by:
- claude-dashboard
- claude-statusline-powerline
- ccstatusline
- Claude Usage Reticle (budget delta concept)