|
2 | 2 |
|
3 | 3 | Ultra-fast Rust implementation of Claude Code usage statusline. |
4 | 4 |
|
| 5 | + |
| 6 | + |
5 | 7 | ## Description |
6 | 8 |
|
7 | 9 | High-performance statusline for Claude Code that displays real-time usage metrics, billing blocks, and burn rates. Written in Rust for sub-millisecond response times with intelligent caching. |
8 | 10 |
|
9 | 11 | ## Features |
10 | 12 |
|
11 | | -- ⚡ **Ultra-fast performance** - 15x faster than Node.js implementation (8ms vs 120ms warm) |
12 | | -- 📊 **Live API integration** - Real-time 5-hour and 7-day utilization from claude.ai API |
13 | | -- 🔼 **Update notifications** - Checks npm registry for Claude Code updates (30-min cache) |
14 | | -- 🕑 **Time remaining** - Shows time left in billing block with clock emoji easter egg |
15 | | -- ⚙️ **Interactive configuration** - Menu-based UI to enable/disable statusline elements |
16 | | -- 🖥️ **Interactive mode** - Works as standalone tool or piped statusline |
17 | | -- 🦊 **Firefox cookie extraction** - Automatic authentication using Firefox profile |
18 | | -- 💰 **Accurate cost tracking** - Fetches daily pricing from LiteLLM, supports tiered pricing |
19 | | -- 🔄 **Smart caching** - XDG_RUNTIME_DIR-based caching with 24-hour pricing cache |
20 | | -- 🎯 **5-hour block tracking** - Matches Claude's billing cycles exactly |
21 | | -- 🧮 **Deduplication** - Prevents double-counting duplicate JSONL entries |
22 | | -- 🔥 **Burn rate monitoring** - Real-time cost per hour with visual indicators |
| 13 | +- **Ultra-fast performance** - 15x faster than Node.js implementation (8ms vs 120ms warm) |
| 14 | +- **Live API integration** - Real-time 5-hour and 7-day utilization via Claude Code OAuth |
| 15 | +- **Update notifications** - Checks for Claude Code updates with configurable channels (stable/latest) |
| 16 | +- **Time remaining** - Shows time left in billing block with clock emoji easter egg |
| 17 | +- **Interactive configuration** - Menu-based UI to enable/disable statusline elements |
| 18 | +- **Interactive mode** - Works as standalone tool or piped statusline |
| 19 | +- **OAuth authentication** - Uses Claude Code's native OAuth tokens from ~/.claude/.credentials.json |
| 20 | +- **Accurate cost tracking** - Fetches daily pricing from LiteLLM, supports tiered pricing |
| 21 | +- **Smart caching** - XDG_RUNTIME_DIR-based caching with 24-hour pricing cache |
| 22 | +- **5-hour block tracking** - Matches Claude's billing cycles exactly |
| 23 | +- **Deduplication** - Prevents double-counting duplicate JSONL entries |
| 24 | +- **Burn rate monitoring** - Real-time cost per hour with visual indicators |
| 25 | +- **Auto-install** - Creates ~/.claude/settings.json if missing during install |
23 | 26 |
|
24 | 27 | ## Inspiration |
25 | 28 |
|
@@ -71,8 +74,11 @@ Configure which elements to display: |
71 | 74 | ccusage-statusline-rs config |
72 | 75 | ``` |
73 | 76 |
|
| 77 | + |
| 78 | + |
74 | 79 | This opens an interactive menu where you can: |
75 | 80 | - Enable/disable individual elements (Model, Block cost, Time remaining, etc.) |
| 81 | +- Choose update notification channel (stable/latest/off) |
76 | 82 | - Configuration persists in `~/.claude/ccusage-statusline-config.json` |
77 | 83 |
|
78 | 84 | ### Manual Configuration (Not Recommended) |
|
0 commit comments