https://github.com/abdallahaho/ccline
A feature-rich Claude Code statusline with session tracking, quota monitoring, peak hour detection, and burn rate projection
https://github.com/abdallahaho/ccline
anthropic claude-code cli developer-tools statusline
Last synced: 3 months ago
JSON representation
A feature-rich Claude Code statusline with session tracking, quota monitoring, peak hour detection, and burn rate projection
- Host: GitHub
- URL: https://github.com/abdallahaho/ccline
- Owner: AbdallahAHO
- License: mit
- Created: 2026-03-30T06:14:54.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-30T06:37:17.000Z (3 months ago)
- Last Synced: 2026-04-03T22:56:36.020Z (3 months ago)
- Topics: anthropic, claude-code, cli, developer-tools, statusline
- Language: Shell
- Homepage: https://www.npmjs.com/package/@abdallahaho/ccline
- Size: 254 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ccline
A feature-rich statusline for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) that helps you track session health, manage quota, and avoid burning through your Max plan.
## What you get
**Line 1 — Identity & Project**
```
O4.6 1M ● high | 📂 really-app (main*) 📝+147 -38 | → src/features/search
```
- Compact model name with effort level
- Project root with git branch and dirty indicator
- Lines changed this session
- Current working directory (relative to project, fish-style if outside)
**Line 2 — Session Health**
```
#84 turns | ⏱ 2h14m | 72% 720k/1m ctx compact? | $12.41
```
- Turn counter (yellow at 30, red at 50 — time to start fresh)
- Session duration
- Context window usage with absolute tokens and compaction nudge at 60%+
- Running session cost (yellow at $5, red at $10)
**Lines 3-4 — Quota & Rate Limits**
```
current ●●●●●●●○○○ 68% resets 3:42pm 🔥 PEAK til 8pm
weekly ●●●●●●●●○○ 81% resets apr 3, 7:00pm ~22%/day
```
- 5-hour and 7-day rate limit bars via Anthropic OAuth API (cached, 60s TTL)
- Peak hour detection (05:00-11:00 PT) with local end time — only shows when active
- Weekly burn rate projection — green if on pace, yellow if tight, red if you'll hit the limit
## Install
```bash
npx @abdallahaho/ccline@latest
```
This copies the statusline script to `~/.claude/statusline.sh` and configures your `~/.claude/settings.json`. Restart Claude Code to see it.
If you already have a custom statusline, it's backed up to `statusline.sh.bak` first.
## Requirements
- `jq`, `curl`, `git`
- Claude Code with an active Max/Pro subscription (for rate limit bars)
```bash
# macOS
brew install jq
# Ubuntu/Debian
sudo apt install jq curl git
```
## Uninstall
```bash
npx @abdallahaho/ccline@latest --uninstall
```
Restores your previous statusline if a backup exists, or removes it and cleans up settings.json.
## How it works
Claude Code pipes a JSON blob to the statusline script on every render. The script extracts model info, context usage, session cost, and workspace data from that JSON. Rate limit data is fetched from the Anthropic OAuth API and cached for 60 seconds at `/tmp/claude/statusline-usage-cache.json`.
The OAuth token is resolved from (in order):
1. `$CLAUDE_CODE_OAUTH_TOKEN` environment variable
2. macOS Keychain
3. `~/.claude/.credentials.json`
4. Linux `secret-tool`
## Credits
Heavily inspired by [kamranahmedse/claude-statusline](https://github.com/kamranahmedse/claude-statusline) by Kamran Ahmed.
## License
MIT