Homebrew Maintenance & Cleanup

# Update Homebrew itself and formula definitions
brew update

# See what's outdated
brew outdated

# Check system health
brew doctor

# Upgrade all packages (review first!)
brew outdated               # Check what will upgrade
brew upgrade                # Upgrade everything

# Or upgrade selectively
brew upgrade git gh neovim  # Only specific packages

# Clean up old versions
brew cleanup --prune=30     # Remove versions older than 30 days
brew autoremove             # Remove unused dependencies

# Sync Brewfile
brew bundle dump --file=~/Brewfile --describe --force

# Full system health check
brew doctor

# Show configuration
brew config

# List installed packages with sizes
brew list --formula | xargs brew info --json | jq -r '.[] | "\(.name): \(.installed[0].installed_on_request)"'

# Find disk usage
du -sh $(brew --cellar)     # Formula storage
du -sh $(brew --caskroom)   # Cask storage

# Check dependencies of a formula
brew deps --tree postgresql@16
brew uses --installed git    # What depends on git

# Pin to prevent accidental upgrades
brew pin postgresql@16
brew pin node@20

# List pinned packages
brew list --pinned

# Unpin when ready to upgrade
brew unpin postgresql@16

# 1. Update formula definitions
brew update

# 2. Review what will change
brew outdated

# 3. Upgrade specific categories
brew upgrade git gh neovim tmux  # CLI tools (safe)
# brew upgrade postgresql@16     # Databases (caution — backup first!)

# 4. Verify nothing broke
brew doctor

# 5. Clean up
brew cleanup --prune=30
brew autoremove