Claude Code Statusline

A minimal, informative statusline for Claude Code CLI.

``
🤖 Opus │ 📊 53% 106K │ ⏱ 26% 2h09 ▼1h32/46% 2d15 ▼1d04 │ 🕌 Asr 15:32 (2h15) │ 🔌 3
`

Features

- 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

Installation

$3

`bash
npm install -g @daliovic/cc-statusline
`

$3

`bash
git clone https://github.com/daliovic/cc-statusline.git
cd cc-statusline
npm install
npm run build
`

Configuration

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
}
}
`

Customization

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.

$3

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.

$3

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)
- Max names - Limit names shown before truncating (e.g., 🔌 reddit, chrome+1)

Reads from ~/.claude.json and respects both global and project-level disabledMcpServers.

$3

| Variable | Default | Description |
|----------|---------|-------------|
| STATUSLINE_CACHE_TTL_MS | config value | API cache duration (overrides config) |

How It Works

- 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

Output Format

`
🤖 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

License

MIT License - Do whatever you want with this. Attribution appreciated but not required.

Credits

Inspired by:
- claude-dashboard
- claude-statusline-powerline
- ccstatusline
- Claude Usage Reticle (budget delta concept)