ccstatusline

High-performance Claude Code status line, support tokens usage statistics.

Features

• Session Info Display: Duration, model name, context usage percentage, project name, Git branch, current directory
• Token Statistics:
  • Multi-dimensional: Day/week/month/total token usage
  • High Performance: Smart caching and concurrent processing, millisecond-level response
• Beautiful Output: ANSI colors, progress bar, separator formatting

Installation

NPM Install (Recommended)

npm install -g @asathinkeroops/ccstatusline

Output Example

⏱ 2h15m30s | ◆ CLAUDE-SONNET-4-6 | ○ ████████░░ 85% | ◈ gateway | ⎇ main | • ~/projects/gateway
────────────────────────────────────────────────────────────────────────────────────────────────────
◇ Day 125.3K | ▸ Week 1.2M | ▪ Month 8.5M | ◉ Total 52.1M

Usage

# Today's usage (default)
ccstatusline tokens-usage

# This week's usage
ccstatusline tokens-usage --period week

# This month's usage
ccstatusline tokens-usage --period month

# This year's usage
ccstatusline tokens-usage --period year

# Total usage
ccstatusline tokens-usage --period total

# All periods at once
ccstatusline tokens-usage --period all

# Specific date range
ccstatusline tokens-usage --start 2026-01-01 --end 2026-03-31

# Filter by model
ccstatusline tokens-usage --model claude-sonnet-4-6

# Filter by project
ccstatusline tokens-usage --project gateway

# Disable cache
ccstatusline tokens-usage --no-cache

# Clear cache
ccstatusline tokens-usage --clear-cache