claude-limitline

claude-limitline

A powerline-style statusline for Claude Code showing real-time usage limits, git info, and model details.

Features

- Powerline Style - Beautiful segmented display with smooth transitions
- 5-Hour Block Limit - Shows current usage percentage with time remaining until reset
- 7-Day Rolling Limit - Tracks weekly usage with progress indicator
- Repository Name - Displays current project/directory name
- Git Branch - Shows current branch with dirty indicator (●)
- Claude Model - Displays the active model (Opus 4.5, Sonnet 4, etc.)
- Multiple Themes - Dark, light, nord, gruvbox, tokyo-night, and rose-pine
- Real-time Tracking - Uses Anthropic's OAuth usage API for accurate data
- Cross-Platform - Works on Windows, macOS, and Linux

Example Output

Prerequisites

- Node.js 18.0.0 or higher
- Claude Code CLI installed and authenticated (for OAuth token)
- Nerd Font (recommended, for powerline symbols)

Installation

From npm (recommended)

From Source

See Development section, then run npm link to make it available globally.

Quick Start

Add to your Claude Code settings file (~/.claude/settings.json):

That's it! The status line will now show your usage limits in Claude Code.
Tip: For faster startup, use "command": "claude-limitline" after installing globally.

Configuration

Create a claude-limitline.json file in your Claude config directory (~/.claude/claude-limitline.json) or .claude-limitline.json in your current working directory:

Configuration Options

Weekly View Modes

The weekly segment supports two view modes for displaying usage limits:

Note: Model-specific limits (Opus/Sonnet) are only available on certain subscription tiers. Smart mode shows only overall usage when using Opus/Haiku, and shows both Sonnet and overall when using…