Merge pull request #6 from charlesjones-dev/feat/ai-statusline-rate-limits

feat(ai-statusline): add rate limit usage display

Author: charlesjones-dev

.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "A curated list of custom Claude Code plugins, agents, and skills for developers.",
-    "version": "2.0.1",
+    "version": "2.0.2",
     "pluginRoot": "./plugins"
   },
   "plugins": [
@@ -154,8 +154,8 @@
     {
       "name": "ai-statusline",
       "source": "./plugins/ai-statusline",
-      "description": "AI-powered status line customization - Interactive setup and edit wizards for configuring Claude Code's status line with progress bars and customizable display options",
-      "version": "1.2.1",
+      "description": "AI-powered status line customization - Interactive setup and edit wizards for configuring Claude Code's status line with progress bars, rate limit display, and customizable display options",
+      "version": "1.2.2",
       "keywords": [
         "ai",
         "statusline",

CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.2] - 2026-03-19
+
+### Added
+
+#### AI-Statusline Plugin (v1.2.2)
+
+- **Added rate limit usage display** - Shows 5-hour and 7-day rate limit percentages with color-coded thresholds (green <50%, yellow 50-79%, red 80%+)
+  - New `SHOW_RATE_LIMITS` configuration option (enabled by default)
+  - Reads `rate_limits.five_hour.used_percentage` and `rate_limits.seven_day.used_percentage` from the statusline JSON input
+  - Requires Claude Code 2.1.80+ (gracefully hidden on older versions where the field is absent)
+  - Updated both Bash and PowerShell script templates
+  - Added to `/statusline-wizard` and `/statusline-edit` question flows
+
 ## [2.0.1] - 2026-02-17
 
 ### Fixed

README.md

@@ -1,6 +1,6 @@
 # Claude Code Plugins for Developers
 
-[![Version](https://img.shields.io/badge/version-2.0.1-blue.svg)](https://github.com/charlesjones-dev/claude-code-plugins-dev/releases)
+[![Version](https://img.shields.io/badge/version-2.0.2-blue.svg)](https://github.com/charlesjones-dev/claude-code-plugins-dev/releases)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![GitHub Issues](https://img.shields.io/github/issues/charlesjones-dev/claude-code-plugins-dev.svg)](https://github.com/charlesjones-dev/claude-code-plugins-dev/issues)
 [![GitHub Stars](https://img.shields.io/github/stars/charlesjones-dev/claude-code-plugins-dev.svg)](https://github.com/charlesjones-dev/claude-code-plugins-dev/stargazers)

plugins/ai-statusline/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-statusline",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "AI-powered status line customization - Interactive setup and edit wizards for configuring Claude Code's status line with progress bars and customizable display options",
   "author": {
     "name": "Charles Jones",

plugins/ai-statusline/README.md

@@ -11,7 +11,7 @@ Provides interactive commands to configure Claude Code's status line with visual
 ### Example Status Line
 
 ```
-Claude Opus 4.5 · 42k/100k ▓▓▓▓░░░░░░ 42% · my-project · main · 5m 23s · 2:45pm · v1.0.24
+Claude Opus 4.6 · 42k/100k ▓▓▓▓░░░░░░ 42% · 5h:12% 7d:4% · my-project · main · 5m 23s · 2:45pm · v2.1.80
 ```
 
 ---
@@ -44,7 +44,7 @@ The wizard asks about three categories of display options:
 1. **Context Display** (what to show about your Claude session)
    - Token count (e.g., "50k/100k")
    - Progress bar (visual percentage indicator)
-   - Model name (e.g., "Claude Opus 4.5")
+   - Model name (e.g., "Claude Opus 4.6")
 
 2. **Project Display** (what to show about your project)
    - Current directory name
@@ -55,6 +55,7 @@ The wizard asks about three categories of display options:
    - Current time
    - Claude Code version
    - Session cost (disabled by default)
+   - Rate limit usage - 5h and 7d windows (requires Claude Code 2.1.80+)
 
 ### `/statusline-edit`
 
@@ -106,7 +107,7 @@ Edit your existing status line configuration.
 
 | Option | Default | Description |
 |--------|---------|-------------|
-| Model name | On | Display model name (e.g., "Claude Opus 4.5") |
+| Model name | On | Display model name (e.g., "Claude Opus 4.6") |
 | Token count | On | Display token usage (e.g., "50k/100k") |
 | Progress bar | On | Display visual progress bar with percentage |
 | Current directory | On | Display current working directory name |
@@ -115,6 +116,7 @@ Edit your existing status line configuration.
 | Current time | On | Display current time |
 | Claude Code version | On | Display Claude Code version number |
 | Session cost | Off | Display session cost in USD |
+| Rate limit usage | On | Display 5-hour and 7-day rate limit percentages (requires Claude Code 2.1.80+) |
 
 ---
 
@@ -132,6 +134,18 @@ The progress bar uses Unicode block characters to show context usage:
 
 Color changes automatically based on usage level to help you monitor context consumption.
 
+### Rate Limit Display
+
+Shows your 5-hour and 7-day rate limit usage with color coding:
+
+```
+5h:12% 7d:4%    (Green - under 50%)
+5h:65% 7d:42%   (Yellow - 50-79%)
+5h:92% 7d:85%   (Red - 80%+)
+```
+
+Requires Claude Code 2.1.80 or later. The `rate_limits` field is not available in earlier versions.
+
 ### Cross-Platform Support
 
 - **Mac/Linux**: Generates `~/.claude/statusline.sh` (Bash script)
@@ -223,6 +237,7 @@ SHOW_COST=false           # Show session cost
 SHOW_DURATION=true        # Show session duration
 SHOW_TIME=true            # Show current time
 SHOW_VERSION=true         # Show Claude Code version
+SHOW_RATE_LIMITS=true     # Show rate limit usage (5h/7d, requires CC 2.1.80+)
 ```
 
 **PowerShell (`~/.claude/statusline.ps1`):**
@@ -236,6 +251,7 @@ $SHOW_COST = $false
 $SHOW_DURATION = $true
 $SHOW_TIME = $true
 $SHOW_VERSION = $true
+$SHOW_RATE_LIMITS = $true
 ```
 
 ---
@@ -267,7 +283,7 @@ Install jq using your package manager (see Requirements section above).
 ## Plugin Details
 
 - **Name:** AI-Statusline
-- **Version:** 1.2.1
+- **Version:** 1.2.2
 - **Type:** UI Customization
 - **Features:**
   - Skills: `/statusline-wizard`, `/statusline-edit`

plugins/ai-statusline/skills/statusline-edit/SKILL.md

@@ -42,6 +42,7 @@ SHOW_COST=false
 SHOW_DURATION=true
 SHOW_TIME=true
 SHOW_VERSION=true
+SHOW_RATE_LIMITS=true
 ```
 
 **For PowerShell scripts**, look for lines like:
@@ -55,6 +56,7 @@ $SHOW_COST = $false
 $SHOW_DURATION = $true
 $SHOW_TIME = $true
 $SHOW_VERSION = $true
+$SHOW_RATE_LIMITS = $true
 ```
 
 Store the current values to use as defaults in the wizard.
@@ -80,21 +82,22 @@ Options (pre-select based on current config):
 - Current time - select if SHOW_TIME=true
 - Claude Code version - select if SHOW_VERSION=true
 - Session cost - select if SHOW_COST=true
+- Rate limit usage (5h/7d) - select if SHOW_RATE_LIMITS=true
 
 ### Phase 4: Update Script
 
 Update ONLY the SHOW_* variables at the top of the existing script file based on wizard selections.
 
 **For Bash**: Use Edit tool to replace the configuration block:
 ```bash
-SHOW_MODEL=true           # Show model name (e.g., "Claude Opus 4.5")
+SHOW_MODEL=true           # Show model name (e.g., "Claude Opus 4.6")
 SHOW_TOKEN_COUNT=true     # Show token usage count (e.g., "50k/100k")
 ...
 ```
 
 **For PowerShell**: Use Edit tool to replace the configuration block:
 ```powershell
-$SHOW_MODEL = $true           # Show model name (e.g., "Claude Opus 4.5")
+$SHOW_MODEL = $true           # Show model name (e.g., "Claude Opus 4.6")
 $SHOW_TOKEN_COUNT = $true     # Show token usage count (e.g., "50k/100k")
 ...
 ```
@@ -120,4 +123,5 @@ Current configuration:
 - Duration: [enabled/disabled]
 - Time: [enabled/disabled]
 - Version: [enabled/disabled]
+- Rate limits: [enabled/disabled]
 ```

plugins/ai-statusline/skills/statusline-wizard/SKILL.md

@@ -39,6 +39,7 @@ Use AskUserQuestion with these grouped questions:
 - Current time - default selected
 - Claude Code version - default selected
 - Session cost - NOT selected by default
+- Rate limit usage (5h/7d) - default selected
 
 ### Success Message
 
@@ -101,6 +102,7 @@ Use the AskUserQuestion tool to gather user preferences. Group questions logical
 - Show session duration (default: yes)
 - Show current time (default: yes)
 - Show Claude Code version (default: yes)
+- Show rate limit usage - 5h and 7d windows (default: yes)
 
 ### Phase 3: Create Script File
 
@@ -154,7 +156,7 @@ Run `chmod +x ~/.claude/statusline.sh` to make the script executable.
 # Configuration - Set these to customize your status line
 # =============================================================================
 
-SHOW_MODEL=true           # Show model name (e.g., "Claude Opus 4.5")
+SHOW_MODEL=true           # Show model name (e.g., "Claude Opus 4.6")
 SHOW_TOKEN_COUNT=true     # Show token usage count (e.g., "50k/100k")
 SHOW_PROGRESS_BAR=true    # Show visual progress bar
 SHOW_DIRECTORY=true       # Show current directory name
@@ -163,6 +165,7 @@ SHOW_COST=false           # Show session cost (useful for API/Pro users)
 SHOW_DURATION=true        # Show session duration
 SHOW_TIME=true            # Show current time
 SHOW_VERSION=true         # Show Claude Code version
+SHOW_RATE_LIMITS=true     # Show rate limit usage (5h/7d windows, requires Claude Code 2.1.80+)
 
 # =============================================================================
 
@@ -283,6 +286,25 @@ else
   fi
 fi
 
+# Rate limits (requires Claude Code 2.1.80+)
+if [ "$SHOW_RATE_LIMITS" = true ]; then
+  rl_5h=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
+  rl_7d=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')
+
+  if [ -n "$rl_5h" ] && [ -n "$rl_7d" ]; then
+    if [ "$rl_5h" -lt 50 ]; then rl_5h_color='32'
+    elif [ "$rl_5h" -lt 80 ]; then rl_5h_color='33'
+    else rl_5h_color='31'; fi
+
+    if [ "$rl_7d" -lt 50 ]; then rl_7d_color='32'
+    elif [ "$rl_7d" -lt 80 ]; then rl_7d_color='33'
+    else rl_7d_color='31'; fi
+
+    [ -n "$output" ] && output="$output · "
+    output="$output\033[${rl_5h_color}m5h:${rl_5h}%\033[0m \033[${rl_7d_color}m7d:${rl_7d}%\033[0m"
+  fi
+fi
+
 # Directory
 if [ "$SHOW_DIRECTORY" = true ]; then
   [ -n "$output" ] && output="$output · "
@@ -331,7 +353,7 @@ printf '%b' "$output"
 # Configuration - Set these to customize your status line
 # =============================================================================
 
-$SHOW_MODEL = $true           # Show model name (e.g., "Claude Opus 4.5")
+$SHOW_MODEL = $true           # Show model name (e.g., "Claude Opus 4.6")
 $SHOW_TOKEN_COUNT = $true     # Show token usage count (e.g., "50k/100k")
 $SHOW_PROGRESS_BAR = $true    # Show visual progress bar
 $SHOW_DIRECTORY = $true       # Show current directory name
@@ -340,6 +362,7 @@ $SHOW_COST = $false           # Show session cost (useful for API/Pro users)
 $SHOW_DURATION = $true        # Show session duration
 $SHOW_TIME = $true            # Show current time
 $SHOW_VERSION = $true         # Show Claude Code version
+$SHOW_RATE_LIMITS = $true     # Show rate limit usage (5h/7d windows, requires Claude Code 2.1.80+)
 
 # =============================================================================
 
@@ -473,6 +496,34 @@ if ($null -ne $usage) {
     }
 }
 
+# Rate limits (requires Claude Code 2.1.80+)
+if ($SHOW_RATE_LIMITS) {
+    $rl = $data.rate_limits
+    if ($null -ne $rl) {
+        $rl_parts = @()
+
+        if ($null -ne $rl.five_hour) {
+            $rl_5h = [int]$rl.five_hour.used_percentage
+            if ($rl_5h -lt 50) { $rl_5h_color = $green }
+            elseif ($rl_5h -lt 80) { $rl_5h_color = $yellow }
+            else { $rl_5h_color = $red }
+            $rl_parts += "${rl_5h_color}5h:${rl_5h}%$reset"
+        }
+
+        if ($null -ne $rl.seven_day) {
+            $rl_7d = [int]$rl.seven_day.used_percentage
+            if ($rl_7d -lt 50) { $rl_7d_color = $green }
+            elseif ($rl_7d -lt 80) { $rl_7d_color = $yellow }
+            else { $rl_7d_color = $red }
+            $rl_parts += "${rl_7d_color}7d:${rl_7d}%$reset"
+        }
+
+        if ($rl_parts.Count -gt 0) {
+            $segments += ($rl_parts -join " ")
+        }
+    }
+}
+
 # Directory
 if ($SHOW_DIRECTORY) {
     $segments += "$blue$current_dir$reset"
@@ -511,7 +562,7 @@ Write-Host -NoNewline ($segments -join $sep)
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| SHOW_MODEL | true | Display model name (e.g., "Claude Opus 4.5") |
+| SHOW_MODEL | true | Display model name (e.g., "Claude Opus 4.6") |
 | SHOW_TOKEN_COUNT | true | Display token usage (e.g., "50k/100k") |
 | SHOW_PROGRESS_BAR | true | Display visual progress bar with percentage |
 | SHOW_DIRECTORY | true | Display current working directory name |
@@ -520,6 +571,7 @@ Write-Host -NoNewline ($segments -join $sep)
 | SHOW_DURATION | true | Display session duration |
 | SHOW_TIME | true | Display current time |
 | SHOW_VERSION | true | Display Claude Code version |
+| SHOW_RATE_LIMITS | true | Display rate limit usage (5h/7d windows, requires Claude Code 2.1.80+) |
 
 ## Important Notes