/analytics:export

Export analytics data for external analysis or reporting.

Context

Check analytics availability:

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 to export." exit 0 fi

TOTAL=$(cat "${SUMMARY_FILE}" | jq -r '.total_invocations') echo "Exporting ${TOTAL} invocations..."

Parameters

• $ARGS

• Format and optional output file:

• json (default) - Export as JSON

• csv

• Export as CSV for spreadsheet analysis

• markdown

• Export as markdown table

Execution

Export analytics data:

ANALYTICS_DIR="${HOME}/.claude-analytics" SUMMARY_FILE="${ANALYTICS_DIR}/summary.json" EVENTS_FILE="${ANALYTICS_DIR}/events.jsonl"

Parse arguments

FORMAT=$(echo "${ARGS}" | awk '{print $1}') OUTPUT_FILE=$(echo "${ARGS}" | awk '{print $2}')

FORMAT=${FORMAT:-json}

case "${FORMAT}" in json) if [[ -n "${OUTPUT_FILE}" ]]; then cat "${SUMMARY_FILE}" > "${OUTPUT_FILE}" echo "✓ Exported to: ${OUTPUT_FILE}" else echo "📦 Analytics Summary (JSON):" echo "" cat "${SUMMARY_FILE}" | jq '.' fi ;;

csv) OUTPUT=${OUTPUT_FILE:-/dev/stdout}

if [[ "${OUTPUT}" == "/dev/stdout" ]]; then
  echo "📦 Analytics Summary (CSV):"
  echo ""
fi

{
  echo "Name,Type,Count,Success,Failure,Success Rate,First Used,Last Used"
  cat "${SUMMARY_FILE}" | jq -r '
    .items |
    to_entries[] |
    [
      .key,
      .value.type,
      .value.count,
      .value.success,
      .value.failure,
      (.value.success * 100 / (.value.success + .value.failure)),
      .value.first_used,
      .value.last_used
    ] |
    @csv
  '
} > "${OUTPUT}"

if [[ "${OUTPUT}" != "/dev/stdout" ]]; then
  echo "✓ Exported to: ${OUTPUT}"
fi
;;

markdown) OUTPUT=${OUTPUT_FILE:-/dev/stdout}

if [[ "${OUTPUT}" == "/dev/stdout" ]]; then
  echo "📦 Analytics Summary (Markdown):"
  echo ""
fi

{
  echo "# Command & Skill Analytics"
  echo ""
  TOTAL=$(cat "${SUMMARY_FILE}" | jq -r '.total_invocations')
  SINCE=$(cat "${SUMMARY_FILE}" | jq -r '.tracking_since')
  echo "**Total invocations:** ${TOTAL}"
  echo "**Tracking since:** ${SINCE}"
  echo ""

  echo "## Commands"
  echo ""
  echo "| Command | Uses | Success | Failure | Success Rate |"
  echo "|---------|------|---------|---------|--------------|"
  cat "${SUMMARY_FILE}" | jq -r '
    .items |
    to_entries[] |
    select(.value.type == "command") |
    "| \(.key) | \(.value.count) | \(.value.success) | \(.value.failure) | \((.value.success * 100 / (.value.success + .value.failure)) | floor)% |"
  ' | sort -t'|' -k2 -nr

  echo ""
  echo "## Skills"
  echo ""
  echo "| Skill | Uses | Success | Failure | Success Rate |"
  echo "|-------|------|---------|---------|--------------|"
  cat "${SUMMARY_FILE}" | jq -r '
    .items |
    to_entries[] |
    select(.value.type == "skill") |
    "| \(.key) | \(.value.count) | \(.value.success) | \(.value.failure) | \((.value.success * 100 / (.value.success + .value.failure)) | floor)% |"
  ' | sort -t'|' -k2 -nr
} > "${OUTPUT}"

if [[ "${OUTPUT}" != "/dev/stdout" ]]; then
  echo "✓ Exported to: ${OUTPUT}"
fi
;;

*) echo "❌ Unknown format: ${FORMAT}" echo "" echo "Supported formats:" echo " • json - JSON format" echo " • csv - CSV for spreadsheet import" echo " • markdown - Markdown table" echo "" echo "Examples:" echo " /analytics:export json" echo " /analytics:export csv analytics.csv" echo " /analytics:export markdown report.md" exit 1 ;; esac

echo "" echo "💡 Tip: Raw event data is in ${EVENTS_FILE}"

Post-actions

None.