How to fix remote: error: File large_file.zip is 150.00 MB; this exceeds GitHub's file size limit of 100.00 MB in Git

# Find all 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

# Or use git-sizer for a comprehensive report
# Install: brew install git-sizer (macOS) or download from GitHub
git-sizer --verbose

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

# See the size of a specific file
git ls-tree -r -l HEAD | grep large_file

# macOS
brew install bfg

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

# Clone a bare repository (required for BFG)
git clone --mirror https://github.com/username/repo.git repo.git
cd repo.git

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

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

# Or remove files matching a pattern
bfg --delete-files "*.zip"

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

# Push the cleaned history (requires force push)
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.zip"

# Remove multiple files
git filter-repo --invert-paths --path "file1.zip" --path "file2.tar.gz"

# Remove files matching a pattern
git filter-repo --invert-paths --path-glob "*.zip"

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

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

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

# Undo the last commit, keeping changes staged
git reset --soft HEAD~1

# Remove the large file from staging
git rm --cached path/to/large_file.zip

# Add to .gitignore
echo "large_file.zip" >> .gitignore

# Re-commit without the large file
git add .gitignore
git commit -m "Your original commit message"

# Start interactive rebase (replace N with number of commits)
git rebase -i HEAD~N

# In the editor, change 'pick' to 'edit' for the commit that added the file
# Save and close

# Remove the large file
git rm --cached path/to/large_file.zip
git commit --amend --no-edit

# Continue the rebase
git rebase --continue

# macOS
brew install git-lfs

# Windows (comes with Git for Windows, or)
git lfs install

# Ubuntu/Debian
apt install git-lfs

# Initialize LFS for your user account (once per machine)
git lfs install

# Track specific file types
git lfs track "*.zip"
git lfs track "*.psd"
git lfs track "*.mp4"

# Track a specific file
git lfs track "path/to/large_file.zip"

# This creates/updates .gitattributes

git add .gitattributes
git commit -m "Configure Git LFS tracking"

# Import existing files into LFS (rewrites history)
git lfs migrate import --include="*.zip" --everything

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

# Add common large file patterns to .gitignore
cat >> .gitignore << 'EOF'
# Large files
*.zip
*.tar.gz
*.rar
*.7z
*.mp4
*.mov
*.psd
*.ai

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

# Dependencies
node_modules/
vendor/

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

git add .gitignore
git commit -m "Update .gitignore to exclude large files"

# Create a pre-commit hook
cat > .git/hooks/pre-commit << 'EOF'
#!/bin/bash
# Prevent commits of files larger than 50MB

MAX_SIZE=$((50 * 1024 * 1024))  # 50MB in bytes

for file in $(git diff --cached --name-only); do
    if [ -f "$file" ]; then
        size=$(wc -c < "$file")
        if [ $size -gt $MAX_SIZE ]; then
            echo "Error: $file is larger than 50MB"
            echo "Consider using Git LFS for large files"
            exit 1
        fi
    fi
done
EOF

chmod +x .git/hooks/pre-commit

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v4.5.0
    hooks:
      - id: check-added-large-files
        args: ['--maxkb=50000']  # 50MB

# Verify the large file is removed
git rev-list --objects --all | \
  git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | \
  awk '/^blob/ && $3 > 100000000 {print}'

# Should return empty if all large files are removed

# Force push to GitHub
git push origin main --force

# Push all branches if needed
git push origin --force --all

# Push tags
git push origin --force --tags

# Safer force push - fails if remote has new commits
git push origin main --force-with-lease

# Team members should run:
git fetch origin
git reset --hard origin/main

# Or re-clone the repository
git clone https://github.com/username/repo.git