mac-cleanup

🧹 mac-cleanup A modular, safe-by-default CLI tool for macOS developers to reclaim disk storage lost to Xcode, Docker, Homebrew, developer build artifacts, and system caches. Built in pure Bash. Installable via Homebrew. Why mac-cleanup? Macs aren't designed to naturally tidy up after developers. Whether you're building apps, managing containers, or experimenting with new environments, your local storage silently shoulders the burden of massive hidden dependencies. Xcode Environments: DerivedData, old project Archives, and iOS DeviceSupport files can quietly swell to consume over 50-100 GB in forgotten storage. Container Ecosystems: Docker Desktop frequently orphans dangling images, ghost containers, and multi-gigabyte build caching layers over time without auto-pruning. Toolchain Leftovers: Every runtime from Node (nodemodules) and Python (pycache) to Gradle and Rust (target/) leaves behind hundreds of stale cache fragments scattered across your home directory. Deceptive System Data: The ambiguous "System Data" block in macOS Storage settings often hides gigabytes of abandoned Time Machine local snapshots, browser frameworks lacking clean deletion patterns, and old .pkg payloads.