aiblueprint-cli 1.0.0

package/claude-code-config/scripts/statusline-ccusage.sh

@@ -0,0 +1,156 @@
+#!/bin/bash
+
+# ANSI color codes
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+PURPLE='\033[0;35m'
+GRAY='\033[0;90m'
+LIGHT_GRAY='\033[0;37m'
+RESET='\033[0m'
+
+# Read JSON input from stdin
+input=$(cat)
+
+# Extract current session ID and model info from Claude Code input
+session_id=$(echo "$input" | jq -r '.session_id // empty')
+model_name=$(echo "$input" | jq -r '.model.display_name // empty')
+current_dir=$(echo "$input" | jq -r '.workspace.current_dir // empty')
+cwd=$(echo "$input" | jq -r '.cwd // empty')
+output_style=$(echo "$input" | jq -r '.output_style.name // empty')
+
+# Get current git branch with error handling
+if git rev-parse --git-dir >/dev/null 2>&1; then
+    branch=$(git branch --show-current 2>/dev/null || echo "detached")
+    if [ -z "$branch" ]; then
+        branch="detached"
+    fi
+    
+    # Check for pending changes (staged or unstaged)
+    if ! git diff-index --quiet HEAD -- 2>/dev/null || ! git diff-index --quiet --cached HEAD -- 2>/dev/null; then
+        # Get line changes for unstaged and staged changes
+        unstaged_stats=$(git diff --numstat 2>/dev/null | awk '{added+=$1; deleted+=$2} END {print added+0, deleted+0}')
+        staged_stats=$(git diff --cached --numstat 2>/dev/null | awk '{added+=$1; deleted+=$2} END {print added+0, deleted+0}')
+        
+        # Parse the stats
+        unstaged_added=$(echo $unstaged_stats | cut -d' ' -f1)
+        unstaged_deleted=$(echo $unstaged_stats | cut -d' ' -f2)
+        staged_added=$(echo $staged_stats | cut -d' ' -f1)
+        staged_deleted=$(echo $staged_stats | cut -d' ' -f2)
+        
+        # Total changes
+        total_added=$((unstaged_added + staged_added))
+        total_deleted=$((unstaged_deleted + staged_deleted))
+        
+        # Build the branch display with changes (with colors)
+        changes=""
+        if [ $total_added -gt 0 ]; then
+            changes="${GREEN}+$total_added${RESET}"
+        fi
+        if [ $total_deleted -gt 0 ]; then
+            if [ -n "$changes" ]; then
+                changes="$changes ${RED}-$total_deleted${RESET}"
+            else
+                changes="${RED}-$total_deleted${RESET}"
+            fi
+        fi
+        
+        if [ -n "$changes" ]; then
+            branch="$branch${PURPLE}*${RESET} ($changes)"
+        else
+            branch="$branch${PURPLE}*${RESET}"
+        fi
+    fi
+else
+    branch="no-git"
+fi
+
+# Get basename of current directory
+dir_name=$(basename "$current_dir")
+
+# Get today's date in YYYYMMDD format
+today=$(date +%Y%m%d)
+
+# Function to format numbers
+format_cost() {
+    printf "%.2f" "$1"
+}
+
+format_tokens() {
+    local tokens=$1
+    if [ "$tokens" -ge 1000000 ]; then
+        printf "%.1fM" "$(echo "scale=1; $tokens / 1000000" | bc -l)"
+    elif [ "$tokens" -ge 1000 ]; then
+        printf "%.1fK" "$(echo "scale=1; $tokens / 1000" | bc -l)"
+    else
+        printf "%d" "$tokens"
+    fi
+}
+
+format_time() {
+    local minutes=$1
+    local hours=$((minutes / 60))
+    local mins=$((minutes % 60))
+    if [ "$hours" -gt 0 ]; then
+        printf "%dh %dm" "$hours" "$mins"
+    else
+        printf "%dm" "$mins"
+    fi
+}
+
+# Initialize variables with defaults
+session_cost="0.00"
+session_tokens=0
+daily_cost="0.00"
+block_cost="0.00"
+remaining_time="N/A"
+
+# Get current session data using ccusage session --id
+if command -v ccusage >/dev/null 2>&1 && [ -n "$session_id" ] && [ "$session_id" != "empty" ]; then
+    # Use the new ccusage session --id functionality to get session data
+    session_data=$(ccusage session --id "$session_id" --json 2>/dev/null)
+    
+    if [ $? -eq 0 ] && [ -n "$session_data" ] && [ "$session_data" != "null" ]; then
+        # Extract cost and tokens from the JSON response
+        session_cost=$(echo "$session_data" | jq -r '.totalCost // 0')
+        # Calculate only input + output tokens (exclude cache tokens for meaningful display)
+        session_tokens=$(echo "$session_data" | jq -r '.entries | map(.inputTokens + .outputTokens) | add // 0')
+    fi
+fi
+
+if command -v ccusage >/dev/null 2>&1; then
+    # Get daily data
+    daily_data=$(ccusage daily --json --since "$today" 2>/dev/null)
+    if [ $? -eq 0 ] && [ -n "$daily_data" ]; then
+        daily_cost=$(echo "$daily_data" | jq -r '.totals.totalCost // 0')
+    fi
+    
+    # Get active block data
+    block_data=$(ccusage blocks --active --json 2>/dev/null)
+    if [ $? -eq 0 ] && [ -n "$block_data" ]; then
+        active_block=$(echo "$block_data" | jq -r '.blocks[] | select(.isActive == true) // empty')
+        if [ -n "$active_block" ] && [ "$active_block" != "null" ]; then
+            block_cost=$(echo "$active_block" | jq -r '.costUSD // 0')
+            remaining_minutes=$(echo "$active_block" | jq -r '.projection.remainingMinutes // 0')
+            if [ "$remaining_minutes" != "0" ] && [ "$remaining_minutes" != "null" ]; then
+                remaining_time=$(format_time "$remaining_minutes")
+            fi
+        fi
+    fi
+fi
+
+# Format the output
+formatted_session_cost=$(format_cost "$session_cost")
+formatted_daily_cost=$(format_cost "$daily_cost")
+formatted_block_cost=$(format_cost "$block_cost")
+formatted_tokens=$(format_tokens "$session_tokens")
+
+# Build the status line with colors (light gray as default)
+status_line="${LIGHT_GRAY}🌿 $branch ${GRAY}|${LIGHT_GRAY} 💄 $output_style ${GRAY}|${LIGHT_GRAY} 📁 $dir_name ${GRAY}|${LIGHT_GRAY} 🤖 $model_name ${GRAY}|${LIGHT_GRAY} 💰 \$$formatted_session_cost ${GRAY}/${LIGHT_GRAY} 📅 \$$formatted_daily_cost ${GRAY}/${LIGHT_GRAY} 🧊 \$$formatted_block_cost"
+
+if [ "$remaining_time" != "N/A" ]; then
+    status_line="$status_line ($remaining_time left)"
+fi
+
+status_line="$status_line ${GRAY}|${LIGHT_GRAY} 🧩 ${formatted_tokens} ${GRAY}tokens${RESET}"
+
+printf "%b\n" "$status_line"

package/claude-code-config/scripts/statusline.readme.md

@@ -0,0 +1,194 @@
+# Claude Code Statusline with ccusage Integration
+
+A custom statusline script that integrates with [ccusage](https://github.com/ryoppippi/ccusage) to display real-time Claude Code usage statistics, including session costs, daily usage, and token counts.
+
+## Features
+
+- 🌿 **Git branch status** with change indicators (+/-) 
+- 📁 **Current directory** name
+- 🤖 **Claude model** being used
+- 💰 **Session cost** for current conversation 
+- 📅 **Daily cost** total
+- 🧊 **Block cost** with remaining time
+- 🧩 **Token count** for current session (input + output only)
+
+## Requirements
+
+- [ccusage](https://github.com/ryoppippi/ccusage) v15.9.4 or later (for `--id` support)
+- `jq` for JSON parsing
+- `git` for repository information
+
+## Installation
+
+```bash
+# Install ccusage
+npm install -g ccusage
+
+# Make script executable
+chmod +x statusline-ccusage.sh
+```
+
+## Usage
+
+The script expects Claude Code input format via stdin:
+
+```bash
+echo '{"session_id":"your-session-id","model":{"display_name":"Claude 3.5 Sonnet"},"workspace":{"current_dir":"/path/to/project"}}' | ./statusline-ccusage.sh
+```
+
+## How It Works
+
+### Session Data Retrieval
+
+The script uses the new `ccusage session --id` functionality (added in ccusage v15.9.4) to fetch session data:
+
+```bash
+ccusage session --id "$session_id" --json
+```
+
+This returns detailed session information including:
+- Total cost for the session
+- Individual message entries with token counts
+- Cache usage statistics
+
+### Token Calculation
+
+**Important**: The script calculates only meaningful conversation tokens:
+
+```bash
+# Only input + output tokens (excludes cache tokens)
+session_tokens=$(echo "$session_data" | jq -r '.entries | map(.inputTokens + .outputTokens) | add // 0')
+```
+
+**Why exclude cache tokens?**
+- Cache tokens represent context being stored/reused internally
+- They don't represent the actual conversation size
+- Including them inflates counts (e.g., 433K vs 2.7K tokens)
+- For statusline display, conversation tokens are more meaningful
+
+## Finding Your Claude Code Session ID
+
+### Method 1: From Session Files
+
+Session IDs are stored as `.jsonl` files in your Claude directory:
+
+```bash
+# Find recent session files
+find ~/.claude -name "*.jsonl" | head -5
+
+# Example output:
+# /Users/user/.claude/projects/project-name/428e9ec6-86f3-43c1-a0cd-9a3986d82229.jsonl
+```
+
+The session ID is the UUID part: `428e9ec6-86f3-43c1-a0cd-9a3986d82229`
+
+### Method 2: From ccusage Session List
+
+```bash
+# List all sessions to see available IDs
+ccusage session
+
+# The session names in the first column can sometimes be used as IDs
+# But UUID-based IDs are more reliable
+```
+
+### Method 3: Test with Known Session
+
+```bash
+# Test if a session ID works
+ccusage session --id "your-session-id" --json
+
+# Returns session data if valid, or null if not found
+```
+
+## Testing the Script
+
+### 1. Test with a Real Session ID
+
+```bash
+# Find a session ID
+SESSION_ID=$(find ~/.claude -name "*.jsonl" | head -1 | xargs basename -s .jsonl)
+
+# Test the script
+echo "{\"session_id\":\"$SESSION_ID\",\"model\":{\"display_name\":\"Claude 3.5 Sonnet\"},\"workspace\":{\"current_dir\":\"$(pwd)\"}}" | ./statusline-ccusage.sh
+```
+
+### 2. Test Individual Components
+
+```bash
+# Test session data retrieval
+ccusage session --id "your-session-id" --json
+
+# Test token calculation
+ccusage session --id "your-session-id" --json | jq '.entries | map(.inputTokens + .outputTokens) | add'
+
+# Test daily usage
+ccusage daily --json --since "$(date +%Y%m%d)"
+
+# Test active blocks
+ccusage blocks --active --json
+```
+
+### 3. Expected Output
+
+The statusline should display something like:
+```
+🌿 main* (+15 -3) | 📁 project-name | 🤖 Claude 3.5 Sonnet | 💰 $0.26 / 📅 $8.03 / 🧊 $8.03 (2h 45m left) | 🧩 2.7K tokens
+```
+
+## Troubleshooting
+
+### ccusage Version Issues
+
+Ensure you have the latest version with `--id` support:
+
+```bash
+# Check version (needs 15.9.4+)
+ccusage --version
+
+# Update if needed
+npm update -g ccusage
+
+# Verify --id option exists
+ccusage session --help | grep -A5 -B5 "id"
+```
+
+### Session ID Not Found
+
+```bash
+# Returns null - session doesn't exist
+ccusage session --id "invalid-id" --json
+
+# Check if session files exist
+ls ~/.claude/projects/*/your-session-id.jsonl
+```
+
+### Permission Issues
+
+```bash
+# Make script executable
+chmod +x statusline-ccusage.sh
+
+# Check file permissions
+ls -la statusline-ccusage.sh
+```
+
+## Integration with Claude Code
+
+This script is designed to work with Claude Code's statusline feature. Configure it in your Claude Code settings to display real-time usage information during your coding sessions.
+
+## What We Improved
+
+### Before (Custom Logic)
+- 50+ lines of complex session file parsing
+- Manual JSONL file searching and parsing
+- Inconsistent cost calculations
+- Included cache tokens (inflated counts)
+
+### After (ccusage Integration)
+- ~10 lines using official ccusage API
+- Reliable session data via `ccusage session --id`
+- Consistent cost calculations matching ccusage
+- Only meaningful conversation tokens displayed
+
+The new approach is more maintainable, accurate, and leverages the official ccusage functionality instead of duplicating complex logic.