User Config: Session Stats

Display aggregate statistics about Claude Code session history, including file counts, storage usage, and trends over time.

Related Skill: Invoke the user-config-management skill for comprehensive user configuration guidance.

Usage

/user-config:session-stats                    # Stats for current project
/user-config:session-stats --all-projects     # Stats across all projects

Arguments

Workflow

Step 1: Gather Statistics

PROJECT_PATH=$(pwd | sed 's/[\/:]/-/g' | sed 's/^-//')
PROJECT_DIR="$HOME/.claude/projects/$PROJECT_PATH"

# Count files
TOTAL=$(ls "$PROJECT_DIR"/*.jsonl 2>/dev/null | wc -l)
SESSIONS=$(ls "$PROJECT_DIR"/*.jsonl 2>/dev/null | grep -v "agent-" | wc -l)
AGENTS=$(ls "$PROJECT_DIR"/agent-*.jsonl 2>/dev/null | wc -l)

# Size calculations
TOTAL_SIZE=$(du -sh "$PROJECT_DIR" 2>/dev/null | cut -f1)

# By age
TODAY=$(find "$PROJECT_DIR" -name "*.jsonl" -mtime 0 2>/dev/null | wc -l)
WEEK=$(find "$PROJECT_DIR" -name "*.jsonl" -mtime -7 2>/dev/null | wc -l)
MONTH=$(find "$PROJECT_DIR" -name "*.jsonl" -mtime -30 2>/dev/null | wc -l)
OLDER=$(find "$PROJECT_DIR" -name "*.jsonl" -mtime +30 2>/dev/null | wc -l)

# Average session size
AVG_SIZE=$(find "$PROJECT_DIR" -name "*.jsonl" ! -name "agent-*" -exec du -b {} + 2>/dev/null | \
  awk '{sum+=$1; count++} END {if(count>0) printf "%.1f", sum/count/1024/1024; else print "0"}')

Step 2: Display Statistics

Session Statistics
==================
Project: D--repos-gh-melodic-claude-code-plugins

File Counts:
  Total files:     2,638
  Session files:   507
  Agent files:     2,131

Storage Usage:
  Total size:      945M
  Sessions:        645M
  Agents:          300M

Session Analysis:
  Average size:    1.3M
  Largest:         15M
  Smallest:        340B

Age Distribution:
  Today:           12 files
  Last 7 days:     245 files
  Last 30 days:    1,817 files
  Older:           821 files

Cleanup Potential:
  Files >7 days:   821 (reclaimable: ~650M)
  Files >30 days:  0

Growth Rate:
  Last 7 days:     +245 files (+312M)
  Average/day:     35 files/day

Recommendations:
  {based on stats}

Example Output

Session Statistics
==================
Project: D--repos-gh-melodic-claude-code-plugins

File Counts:
  Total files:     2,638
  Session files:   507
  Agent files:     2,131 (4.2x sessions!)

Storage Usage:
  Total size:      945M
  Sessions:        645M (68%)
  Agents:          300M (32%)

Session Analysis:
  Average size:    1.3M per session
  Largest:         15M (55e42424-f5b6-4a26)
  Smallest:        340B

Age Distribution:
  Today:           12 files (0.5%)
  Last 7 days:     245 files (9%)
  Last 30 days:    1,817 files (69%)
  Older:           821 files (31%)

Cleanup Potential:
  Files >7 days:   821 files
  Estimated size:  ~650M (69% of total)

Growth Rate:
  This week:       +245 files
  Average:         ~35 files/day

ALERT: Agent file count (2,131) is 4.2x session count (507)
       This indicates heavy subagent usage. Consider:
       - /user-config:cleanup-agents 7 to free ~245M
       - Breaking large tasks into smaller sessions

Notes

• High agent-to-session ratio indicates heavy Task tool usage
• Large average session size suggests long conversations
• Growth rate helps predict storage needs
• Use /user-config:cleanup-sessions or /user-config:cleanup-agents to act on findings