tomevault-io Context efficiency report
Analyze the Claude Code JSONL session data for the current project to generate a context efficiency report.
When to invoke
- When reviewing Claude Code session efficiency
- To understand model usage patterns
- When optimizing for cost reduction
- After completing a project to review usage
Instructions
Project path detection
The current working directory is: $ARGUMENTS (if provided) or $CWD
Convert the path to the Claude projects folder format:
- Replace
/with- - The projects folder is at:
~/.dotfiles/claude.symlink/projects/
Analysis script
Run this analysis for the current project:
#!/bin/bash
CWD="${ARGUMENTS:-$(pwd)}"
PROJECT_KEY=$(echo "$CWD" | sed 's|/|-|g; s|\.|-|g')
PROJECTS_BASE="$HOME/.dotfiles/claude.symlink/projects"
PROJECT_DIR="$PROJECTS_BASE/$PROJECT_KEY"
if [ ! -d "$PROJECT_DIR" ]; then
echo "No session data found for: $CWD"
echo "Looking in: $PROJECT_DIR"
exit 1
fi
echo "╔══════════════════════════════════════════════════════════════════╗"
echo "║ Context Efficiency Report: $(basename "$CWD" | head -c 20)"
echo "╚══════════════════════════════════════════════════════════════════╝"
echo "Project: $CWD"
echo ""
# Session counts
session_count=$(find "$PROJECT_DIR" -maxdepth 1 -name "*.jsonl" ! -name "agent-*.jsonl" 2>/dev/null | wc -l | tr -d ' ')
agent_count=$(find "$PROJECT_DIR" -maxdepth 1 -name "agent-*.jsonl" 2>/dev/null | wc -l | tr -d ' ')
echo "📁 SESSIONS"
echo "────────────────────────────────────────────────────────────────────"
echo "Main Sessions: $session_count"
echo "Agent Sessions: $agent_count"
if [ "$session_count" -gt 0 ]; then
ratio=$(echo "scale=2; $agent_count / $session_count" | bc)
echo "Delegation Ratio: ${ratio}:1"
fi
echo ""
# Model usage
echo "🤖 MODEL USAGE"
echo "────────────────────────────────────────────────────────────────────"
find "$PROJECT_DIR" -maxdepth 1 -name "*.jsonl" -size +1k -exec cat {} + 2>/dev/null | \
jq -r 'select(.message.model != null) | .message.model' 2>/dev/null | \
sort | uniq -c | sort -rn
echo ""
# Tool usage
echo "🔧 TOOL USAGE"
echo "────────────────────────────────────────────────────────────────────"
find "$PROJECT_DIR" -maxdepth 1 -name "*.jsonl" -size +1k -exec cat {} + 2>/dev/null | \
jq -r '.message.content[]? | select(.type == "tool_use") | .name' 2>/dev/null | \
sort | uniq -c | sort -rn | head -15
echo ""
# Size
echo "📊 DATA SIZE"
echo "────────────────────────────────────────────────────────────────────"
total_size=$(du -sh "$PROJECT_DIR" 2>/dev/null | cut -f1)
msg_count=$(find "$PROJECT_DIR" -maxdepth 1 -name "*.jsonl" -exec cat {} + 2>/dev/null | wc -l | tr -d ' ')
echo "Total Size: $total_size"
echo "Message Records: $msg_count"
echo ""
# Collect tool data once
all_tools=$(find "$PROJECT_DIR" -maxdepth 1 -name "*.jsonl" -size +1k -exec cat {} + 2>/dev/null | jq -r '.message.content[]? | select(.type == "tool_use") | .name' 2>/dev/null)
all_models=$(find "$PROJECT_DIR" -maxdepth 1 -name "*.jsonl" -size +1k -exec cat {} + 2>/dev/null | jq -r '.message.model // empty' 2>/dev/null)
# Model counts
opus=$(echo "$all_models" | grep -c "opus" || echo 0)
sonnet=$(echo "$all_models" | grep -c "sonnet" || echo 0)
haiku=$(echo "$all_models" | grep -c "haiku" || echo 0)
model_total=$((opus + sonnet + haiku))
# Tool counts
bash_count=$(echo "$all_tools" | grep -c "^Bash$" || echo 0)
grep_count=$(echo "$all_tools" | grep -c "^Grep$" || echo 0)
glob_count=$(echo "$all_tools" | grep -c "^Glob$" || echo 0)
todo_count=$(echo "$all_tools" | grep -c "^TodoWrite$" || echo 0)
task_count=$(echo "$all_tools" | grep -c "^Task$" || echo 0)
# Calculate scores
score=0
warnings=""
# 1. Model score (30 pts): 50% opus = 30pts, 100% opus = 0pts
if [ "$model_total" -gt 0 ]; then
opus_pct=$((opus * 100 / model_total))
model_score=$((30 - (opus_pct - 50) * 30 / 50))
[ "$model_score" -lt 0 ] && model_score=0
[ "$model_score" -gt 30 ] && model_score=30
score=$((score + model_score))
[ "$opus_pct" -gt 80 ] && warnings="${warnings}⚠️ Opus ${opus_pct}% - apply --model haiku for exploration\n"
else
opus_pct=0
model_score=15
score=$((score + model_score))
fi
# 2. Delegation score (25 pts): 3:1 = 25pts, 0:1 = 0pts
if [ "$session_count" -gt 0 ]; then
delegation_ratio_x100=$((agent_count * 100 / session_count))
delegation_score=$((delegation_ratio_x100 * 25 / 300))
[ "$delegation_score" -gt 25 ] && delegation_score=25
score=$((score + delegation_score))
[ "$delegation_ratio_x100" -lt 100 ] && warnings="${warnings}⚠️ Low delegation - apply Task agents more\n"
else
delegation_score=0
fi
# 3. Tool efficiency score (25 pts): native tools vs bash
native_search=$((grep_count + glob_count))
if [ "$bash_count" -gt 0 ]; then
tool_ratio_x100=$((native_search * 100 / bash_count))
tool_score=$((tool_ratio_x100 * 25 / 50))
[ "$tool_score" -gt 25 ] && tool_score=25
score=$((score + tool_score))
[ "$tool_ratio_x100" -lt 10 ] && warnings="${warnings}⚠️ Bash/Native ratio - prefer Grep/Glob tools\n"
else
tool_score=25
score=$((score + tool_score))
fi
# 4. TodoWrite score (20 pts): task tracking
if [ "$msg_count" -gt 0 ]; then
todo_ratio_x1000=$((todo_count * 1000 / msg_count))
todo_score=$((todo_ratio_x1000 * 20 / 50))
[ "$todo_score" -gt 20 ] && todo_score=20
score=$((score + todo_score))
[ "$todo_count" -eq 0 ] && warnings="${warnings}⚠️ No TodoWrite - apply for task tracking\n"
else
todo_score=0
fi
# Output
echo "📈 EFFICIENCY SCORE"
echo "────────────────────────────────────────────────────────────────────"
echo ""
echo " ┌─────────────────────────────────────┐"
printf " │ SCORE: %3d / 100 │\n" "$score"
echo " └─────────────────────────────────────┘"
echo ""
echo " Breakdown:"
printf " Model efficiency: %2d/30 (Opus %d%%)\n" "$model_score" "$opus_pct"
del_ratio=$(echo "scale=1; $agent_count / ($session_count + 0.001)" | bc)
printf " Task delegation: %2d/25 (ratio %s:1)\n" "$delegation_score" "$del_ratio"
printf " Tool efficiency: %2d/25 (Grep+Glob: %d, Bash: %d)\n" "$tool_score" "$native_search" "$bash_count"
printf " Task tracking: %2d/20 (TodoWrite: %d)\n" "$todo_score" "$todo_count"
echo ""
if [ -n "$warnings" ]; then
echo " Warnings:"
printf " $warnings"
fi
echo ""
echo "═══════════════════════════════════════════════════════════════════"
echo "Generated: $(date '+%Y-%m-%d %H:%M')"
Output
Present the results and provide recommendations based on:
- Model usage distribution (aim for <50% Opus)
- Tool efficiency (Grep > bash grep, Glob > bash find)
- Task delegation ratio (aim for >2:1)
- TodoWrite usage for task tracking
Converted and distributed by TomeVault — claim your Tome and manage your conversions.