/analytics:report
Display usage analytics for commands and skills across all projects.
Context
Check if analytics data exists:
if [[ -f ~/.claude-analytics/summary.json ]]; then
echo "Analytics available"
SUMMARY=$(cat ~/.claude-analytics/summary.json)
TOTAL=$(echo "$SUMMARY" | jq -r '.total_invocations // 0')
SINCE=$(echo "$SUMMARY" | jq -r '.tracking_since // "unknown"')
echo "Total invocations: $TOTAL"
echo "Tracking since: $SINCE"
else
echo "No analytics data found. Start using commands to collect data."
exit 0
fiParameters
$ARGS- Optional filter:
- Empty: Show all analytics - commands: Show only commands - skills: Show only skills - <name>: Show specific command/skill details
Execution
Display analytics report:
ANALYTICS_DIR="${HOME}/.claude-analytics"
SUMMARY_FILE="${ANALYTICS_DIR}/summary.json"
EVENTS_FILE="${ANALYTICS_DIR}/events.jsonl"
if [[ ! -f "${SUMMARY_FILE}" ]]; then
echo "📊 No analytics data yet"
echo ""
echo "Analytics will be collected automatically as you use commands and skills."
echo "Data is stored in: ${ANALYTICS_DIR}"
exit 0
fi
SUMMARY=$(cat "${SUMMARY_FILE}")
FILTER="${ARGS:-all}"
echo "📊 Command & Skill Analytics"
echo ""
# Header info
TOTAL=$(echo "$SUMMARY" | jq -r '.total_invocations')
SINCE=$(echo "$SUMMARY" | jq -r '.tracking_since')
echo "Total invocations: ${TOTAL}"
echo "Tracking since: ${SINCE}"
echo ""
# Top used items
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "Most Used"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
if [[ "${FILTER}" == "all" || "${FILTER}" == "commands" ]]; then
echo ""
echo "📝 Commands"
echo "$SUMMARY" | jq -r '
.items |
to_entries |
map(select(.value.type == "command")) |
sort_by(-.value.count) |
.[:10] |
.[] |
" \(.value.count | tostring | (. + " ")[:6]) \(.key) (\(.value.success)✓ \(.value.failure)✗)"
'
fi
if [[ "${FILTER}" == "all" || "${FILTER}" == "skills" ]]; then
echo ""
echo "🎯 Skills"
echo "$SUMMARY" | jq -r '
.items |
to_entries |
map(select(.value.type == "skill")) |
sort_by(-.value.count) |
.[:10] |
.[] |
" \(.value.count | tostring | (. + " ")[:6]) \(.key) (\(.value.success)✓ \(.value.failure)✗)"
'
fi
# Success rate
if [[ "${FILTER}" == "all" ]]; then
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "Success Rates"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
TOTAL_SUCCESS=$(echo "$SUMMARY" | jq '[.items[].success] | add // 0')
TOTAL_FAILURE=$(echo "$SUMMARY" | jq '[.items[].failure] | add // 0')
TOTAL_OPS=$((TOTAL_SUCCESS + TOTAL_FAILURE))
if [[ $TOTAL_OPS -gt 0 ]]; then
SUCCESS_RATE=$(echo "scale=1; ${TOTAL_SUCCESS} * 100 / ${TOTAL_OPS}" | bc)
echo " Overall: ${SUCCESS_RATE}% (${TOTAL_SUCCESS}✓ ${TOTAL_FAILURE}✗)"
fi
# Items with failures
echo ""
echo " Items with failures:"
echo "$SUMMARY" | jq -r '
.items |
to_entries |
map(select(.value.failure > 0)) |
sort_by(-.value.failure) |
.[:5] |
.[] |
" \(.key): \(.value.failure) failures"
' | while read -r line; do
if [[ -n "$line" ]]; then
echo "$line"
else
echo " None!"
fi
done
fi
# Recent activity
if [[ "${FILTER}" == "all" ]]; then
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "Recent Activity (last 10)"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
if [[ -f "${EVENTS_FILE}" ]]; then
tail -10 "${EVENTS_FILE}" | jq -r '
"\(.timestamp | split("T")[0] + " " + (.timestamp | split("T")[1] | split(".")[0])) \(.name) " +
(if .success then "✓" else "✗" end)
'
fi
fi
# Specific item details
if [[ "${FILTER}" != "all" && "${FILTER}" != "commands" && "${FILTER}" != "skills" ]]; then
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "Details: ${FILTER}"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "$SUMMARY" | jq -r \
--arg name "${FILTER}" \
'
if .items[$name] then
.items[$name] |
"Type: \(.type)\n" +
"Total uses: \(.count)\n" +
"Successful: \(.success)\n" +
"Failed: \(.failure)\n" +
"First used: \(.first_used)\n" +
"Last used: \(.last_used)"
else
"No data found for: " + $name
end
'
# Show recent invocations
if [[ -f "${EVENTS_FILE}" ]]; then
echo ""
echo "Recent invocations:"
grep "\"${FILTER}\"" "${EVENTS_FILE}" | tail -5 | jq -r '
" \(.timestamp) " +
(if .success then "✓" else "✗ \(.error)" end)
'
fi
fi
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "💡 Tips:"
echo " • /analytics:report commands - Show only commands"
echo " • /analytics:report skills - Show only skills"
echo " • /analytics:unused - Find never-used commands"
echo " • /analytics:clear - Reset analytics data"Post-actions
None.