ccusage-statusline-rs

Ultra-fast Rust implementation of Claude Code usage statusline.

Description

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.

Features

• ⚡ Ultra-fast performance - 15x faster than Node.js implementation (8ms vs 120ms warm)
• 💰 Accurate cost tracking - Fetches daily pricing from LiteLLM, supports tiered pricing
• 🔄 Smart caching - XDG_RUNTIME_DIR-based caching with 24-hour pricing cache
• 🎯 5-hour block tracking - Matches Claude's billing cycles exactly
• 🧮 Deduplication - Prevents double-counting duplicate JSONL entries
• 🔥 Burn rate monitoring - Real-time cost per hour with visual indicators

Inspiration

This project is a Rust reimplementation of the statusline feature from ccusage by ryoppippi. The original TypeScript implementation provided the architecture and pricing logic that this Rust version optimizes for performance.

Installation

cargo build --release

The binary will be at target/release/ccusage-statusline-rs.

Usage

Designed to be used as a Claude Code statusline hook. Add to your ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "input=$(cat); dir=$(echo \"$input\" | jq -r '.workspace.current_dir' | sed 's|^/home/user|~|'); ccusage_output=$(echo \"$input\" | /path/to/ccusage-statusline-rs 2>/dev/null | head -1); printf '%s \\033[32m%s\\033[0m' \"$ccusage_output\" \"$dir\""
  }
}

Performance

• Rust: ~8ms average (consistent across all runs)
• Node.js warm: ~120ms average (after JIT warmup)
• Speedup: 15x faster

License

MIT - See LICENSE file for details.