macOS system health toolkit with 5 audit modules (packages, environment, security, cleanup, resources) and cleanup executor. Fixed bugs from review: - Replace GNU timeout with perl alarm (macOS compatible) - Remove Linux-only ps --sort flag, use portable sort - Add JSON escaping to all audit scripts - Remove redundant classify_size branch Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.9 KiB
1.9 KiB
Package Manager Reference
Homebrew
Update workflow
brew update # Update Homebrew itself and formulae list
brew outdated # List outdated formulae
brew outdated --cask # List outdated casks
brew upgrade # Upgrade all outdated formulae
brew upgrade <name> # Upgrade specific formula
brew upgrade --cask # Upgrade all casks
brew cleanup --prune=0 # Remove all cached downloads
brew autoremove # Remove orphaned dependencies
brew doctor # Diagnose issues
Safety notes
brew upgradeis generally safe but can break projects pinned to specific versions- Always check
brew doctorwarnings — some are cosmetic, some indicate real issues brew autoremoveonly removes packages not depended on by anything
npm / nvm
Update workflow
nvm ls # List installed Node versions
nvm install --lts # Install latest LTS
npm outdated -g # Check global packages
npm update -g # Update all global packages
npm cache clean --force # Clear npm cache
Safety notes
- Global npm packages are version-independent from project dependencies
- Updating global packages won't affect project-level node_modules
Python / pyenv
Update workflow
pyenv versions # List installed versions
pyenv install --list # Available versions
pip list --outdated # Outdated packages in current env
pip install --upgrade <pkg> # Upgrade specific package
pip cache purge # Clear pip cache
Safety notes
- Only audit pyenv-managed environments (not system Python)
- pip upgrades can break dependency chains — suggest
--dry-runfirst - Virtual environments in project directories are not scanned (out of scope v1)