How to fix error: file has been evicted by iCloud Drive in Git

# Navigate to your repository
cd /path/to/your/repo

# Download all evicted files recursively
find . -type f -exec brctl download {} \;

# Find and download only evicted files (those with .icloud extension)
find . -name '.*icloud' | perl -pe 's|(.*)/.(.*).icloud|$1/$2|s' | while read file; do brctl download "$file"; done

# Watch iCloud download activity
brctl log -w -t

# Materialize files (download them locally)
find . -type f -exec fileproviderctl materialize {} \;

cd /path/to/your/repo

# Download everything in .git
find .git -type f -exec brctl download {} \;

# These are the most commonly evicted and problematic
find .git/objects -type f -exec brctl download {} \;

find .git/refs -type f -exec brctl download {} \;
brctl download .git/HEAD
brctl download .git/index

# List any evicted files in .git directory
find .git -name '*.icloud' -o -name '.*icloud'

git status
git log --oneline -5

# Check iCloud Drive status
brctl status

# List any remaining evicted files
find ~/Library/Mobile\ Documents -name '*.icloud'

# Create a local-only development folder
mkdir -p ~/dev

# Or use another non-synced location
mkdir -p ~/code
mkdir -p ~/projects

# First, ensure all files are downloaded
cd ~/Library/Mobile\ Documents/com~apple~CloudDocs/your-repo
find . -type f -exec brctl download {} \;

# Wait for downloads to complete, then move
mv ~/Library/Mobile\ Documents/com~apple~CloudDocs/your-repo ~/dev/your-repo

# Or if it's in Documents (synced to iCloud)
mv ~/Documents/your-repo ~/dev/your-repo

# If the repo is too damaged, clone a fresh copy
cd ~/dev
git clone https://github.com/user/repo.git

# Or from a local backup/remote
git clone /path/to/backup/repo.git

# Verify Documents is no longer synced
ls -la ~/Documents

# Files should no longer have cloud status
xattr -l ~/Documents/your-repo

# Rename folder to prevent sync
mv ~/Documents/my-repo ~/Documents/my-repo.nosync

cd /path/to/your/repo

# Look for numbered suffixes (indicates sync conflicts)
ls -la .git/refs/heads/
ls -la .git/refs/remotes/origin/

# Backup .git first!
cp -r .git .git-backup

# Remove the conflicting duplicate
# Keep the original, remove the one with suffix
rm ".git/refs/heads/main 2"

# Or if only the suffixed version exists, rename it
mv ".git/refs/heads/main 2" .git/refs/heads/main

# Fetch fresh refs from remote
git fetch origin

# Reset local branches to match remote
git checkout main
git reset --hard origin/main

# Check for any remaining conflicts
find .git/refs -name "* *"  # Files with spaces

# Validate repository
git fsck --full

# Create a sparse disk image (grows as needed, max 50GB)
hdiutil create -size 50g -type SPARSEBUNDLE -fs "APFS" -volname "GitRepos" ~/Library/Mobile\ Documents/com~apple~CloudDocs/GitRepos.sparsebundle

# Mount it
hdiutil attach ~/Library/Mobile\ Documents/com~apple~CloudDocs/GitRepos.sparsebundle

# It will mount at /Volumes/GitRepos
cd /Volumes/GitRepos

# Clone or move repositories into the mounted volume
git clone https://github.com/user/repo.git /Volumes/GitRepos/repo

#!/bin/bash
hdiutil attach ~/Library/Mobile\ Documents/com~apple~CloudDocs/GitRepos.sparsebundle -nobrowse

hdiutil detach /Volumes/GitRepos

# Clone a fresh copy from remote
cd ~/dev
git clone https://github.com/user/repo.git repo-fresh

# Copy uncommitted changes from corrupted repo (if any)
# First, list what files have changes
cd /path/to/corrupted/repo
git status  # May fail, use ls instead

# Manually copy changed files
cp -r src/* ~/dev/repo-fresh/src/

# If .git is corrupted but files are intact
cd /path/to/corrupted/repo

# Remove corrupted .git
rm -rf .git

# Initialize fresh repository
git init

# Add remote and fetch history
git remote add origin https://github.com/user/repo.git
git fetch origin

# Reset to remote state, keeping local changes
git reset origin/main

# Now you can commit your local changes
git status
git add .
git commit -m "Recovered local changes"

# Install git-repair (via Homebrew)
brew install git-repair

# Attempt automatic repair
cd /path/to/repo
git-repair --force

# If you have another clone of the repo
git remote add recovery /path/to/other/clone
git fetch recovery

# Store repos in dedicated non-synced directories
mkdir -p ~/dev ~/code ~/projects

# GitHub, GitLab, or Bitbucket for remote backup
git remote add origin [email protected]:user/repo.git
git push -u origin main

# Add extended attribute to prevent sync (may not work reliably)
xattr -w com.apple.fileprovider.ignore 1 .git

# Periodically verify repository integrity
git fsck --full

# Compact repository to reduce number of loose objects
git gc --aggressive

# Always ensure files are downloaded first
cd /path/to/repo
find .git -type f -exec brctl download {} \;

# Wait a moment for downloads
sleep 5

# Then proceed with Git operations
git status

# Create local backup before major operations
cp -r .git .git-backup-$(date +%Y%m%d)

cd /path/to/your/repo

# Check repository status
git status

# View recent history
git log --oneline -10

# Check for any corruption
git fsck --full

# Create and commit a test file
echo "test" > test-file.txt
git add test-file.txt
git commit -m "Test commit after iCloud fix"

# Remove test file
git rm test-file.txt
git commit -m "Remove test file"

# Create and switch branches
git checkout -b test-branch
git checkout main
git branch -d test-branch

# Check for any remaining .icloud files
find . -name '*.icloud' -o -name '.*icloud'

# Should return empty if all files are downloaded

# Check iCloud status periodically
brctl status

# List evicted files in iCloud Drive
find ~/Library/Mobile\ Documents -name '*.icloud' | head -20