How to fix remote: error: GH001: Large files detected. You may want to try Git Large File Storage in Git

# Find files larger than 100MB in your repository history
git rev-list --objects --all | \
  git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | \
  awk '/^blob/ {print substr($0,6)}' | \
  sort -rnk2 | \
  head -20

# Show commits that modified the large file
git log --all --full-history -- "path/to/large_file.bin"

# Check the current size
git ls-tree -r -l HEAD | sort -k 3 -n -r | head -10

# Undo the last commit but keep all changes in your working directory
git reset --soft HEAD~1

# Remove the large file from staging
git reset HEAD path/to/large_file.bin

# Add the file to .gitignore so it won't be committed again
echo "path/to/large_file.bin" >> .gitignore
# Or use a pattern: echo "*.bin" >> .gitignore

# Stage and commit everything except the large file
git add .
git commit -m "Your commit message (without large file)"

git status
# Shows: Your branch is ahead of 'origin/main' by N commits

# Reset back N commits (keeps your changes)
git reset HEAD~N

# Now selectively re-add and commit without the large file

# macOS
brew install bfg

# Or download the JAR from https://rtyley.github.io/bfg-repo-cleaner/
# Requires Java 11+

# First, delete the file from your current commit if present
git rm path/to/large_file.bin
git commit -m "Remove large file"
git push  # This will still fail, that's okay

# Clone a fresh mirror of your repo
git clone --mirror https://github.com/username/repo.git repo.git
cd repo.git

# Remove all files larger than 100MB from history
bfg --strip-blobs-bigger-than 100M

# Or remove a specific file by name
bfg --delete-files large_file.bin

# Clean up the repository
git reflog expire --expire=now --all
git gc --prune=now --aggressive

# Push the cleaned history
git push --force

# macOS
brew install git-filter-repo

# pip (any platform)
pip install git-filter-repo

# Ubuntu/Debian
apt install git-filter-repo

# Remove a specific file from all history
git filter-repo --invert-paths --path "path/to/large_file.bin" --force

# Remove files by extension
git filter-repo --invert-paths --path-glob "*.bin" --force

# Remove all files larger than 100MB
git filter-repo --strip-blobs-bigger-than 100M --force

# filter-repo removes the remote for safety; re-add it
git remote add origin https://github.com/username/repo.git

# Force push all branches and tags
git push origin --force --all
git push origin --force --tags

# macOS
brew install git-lfs

# Windows (included with Git for Windows)
git lfs install

# Ubuntu/Debian
apt install git-lfs

# Initialize LFS (once per machine)
git lfs install

# Track by extension
git lfs track "*.psd"
git lfs track "*.mp4"
git lfs track "*.zip"

# Track a specific file
git lfs track "assets/large_dataset.bin"

# Commit the .gitattributes file
git add .gitattributes
git commit -m "Configure Git LFS tracking"

# Convert existing files in history to LFS
git lfs migrate import --include="*.bin" --everything

# Force push the rewritten history
git push origin --force --all

# Add common large file patterns
cat >> .gitignore << 'EOF'
# Large binaries
*.zip
*.tar.gz
*.rar
*.7z
*.bin

# Media files
*.mp4
*.mov
*.psd
*.ai

# Build artifacts
dist/
build/
*.exe
*.dll

# Dependencies
node_modules/
vendor/

# Data files
*.csv
*.sql
*.sqlite
EOF

git add .gitignore
git commit -m "Add patterns to prevent large file commits"

cat > .git/hooks/pre-commit << 'EOF'
#!/bin/bash
# Block commits with files larger than 50MB

MAX_SIZE=$((50 * 1024 * 1024))

for file in $(git diff --cached --name-only --diff-filter=ACM); do
    if [ -f "$file" ]; then
        size=$(wc -c < "$file" | tr -d ' ')
        if [ "$size" -gt "$MAX_SIZE" ]; then
            echo "ERROR: $file is $(($size / 1024 / 1024))MB (limit: 50MB)"
            echo "Use Git LFS for large files: git lfs track '$file'"
            exit 1
        fi
    fi
done
EOF

chmod +x .git/hooks/pre-commit

# Check for any remaining large files
git rev-list --objects --all | \
  git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | \
  awk '/^blob/ && $3 > 100000000 {print}'

# Should return nothing if all large files are removed

# Use --force-with-lease for safety (fails if remote changed)
git push origin main --force-with-lease

# Or force push all branches
git push origin --force --all
git push origin --force --tags

# Option 1: Re-clone (cleanest)
cd ..
rm -rf repo
git clone https://github.com/username/repo.git

# Option 2: Hard reset
git fetch origin
git reset --hard origin/main