feat: add large-file-script.

large-files

@@ -0,0 +1,61 @@
+#!/bin/bash
+
+set -e
+
+# Function to display help message
+usage() {
+	cat <<EOF
+Usage: large-files [N]
+
+Find the top N largest files in a Git repository.
+
+Arguments:
+  N    Number of large files to display (default: 20)
+
+Description:
+  This script scans the entire Git history and identifies the largest files that
+  have ever existed in the repository. It uses 'git rev-list' to extract object
+  sizes and sorts them to display the largest files.
+
+Requirements:
+  - Ensure you're inside a Git repository.
+  - Install 'numfmt' (available in GNU coreutils) for better size formatting.
+
+Examples:
+  large-files        # Show top 20 largest files
+  large-files 50     # Show top 50 largest files
+EOF
+	exit 0
+}
+
+# Default number of files to display
+NUM_FILES=20
+
+# Parse command-line argument
+if [[ $# -gt 1 ]]; then
+	usage
+elif [[ $# -eq 1 ]]; then
+	NUM_FILES="$1"
+	if ! [[ "$NUM_FILES" =~ ^[0-9]+$ ]]; then
+		echo "Error: N must be a valid integer."
+		usage
+	fi
+fi
+
+# Ensure we are inside a Git repository
+if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+	echo "Error: Not inside a Git repository."
+	exit 1
+fi
+
+echo "🔍 Finding the $NUM_FILES largest files in the repository..."
+
+# Extract large files from Git history
+git rev-list --objects --all |
+	git cat-file --batch-check='%(objectsize:disk) %(rest)' |
+	sort -rh |
+	head -n "$NUM_FILES" |
+	awk '{ printf "%10s %s\n", $1, $2 }' |
+	numfmt --to=iec-i --suffix=B --padding=7 --field=1
+
+echo "✅ Done!"