A beautiful, interactive terminal script for cleaning up system data on macOS. Free up gigabytes of disk space with a gorgeous UI, smart prompts, and safe deletion practices.
- 🎨 Beautiful Terminal UI - Colorful interface with progress indicators and visual feedback
- 🔒 Safe & Interactive - Prompts before deleting large caches, shows sizes before cleanup
- 📊 Real-time Stats - Shows space freed with human-readable sizes (GB/MB/KB)
- 🧪 Dry Run Mode - Preview what will be deleted without actually removing anything
- 🎯 Smart Detection - Only cleans what exists on your system, skips missing tools
- 📦 Comprehensive Coverage - Cleans development tools, browsers, and system caches
██████╗ ██╗██╗ ██╗ █████╗ ███╗ ██╗███████╗
██╔══██╗██║██║ ██╔╝██╔══██╗████╗ ██║██╔════╝
██║ ██║██║█████╔╝ ███████║██╔██╗ ██║███████╗
██║ ██║██║██╔═██╗ ██╔══██║██║╚██╗██║╚════██║
██████╔╝██║██║ ██╗██║ ██║██║ ╚████║███████║
╚═════╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═══╝╚══════╝
██████╗ ██████╗ ██████╗ ████████╗
██╔══██╗██╔═══██╗██╔═══██╗╚══██╔══╝
██████╔╝██║ ██║██║ ██║ ██║
██╔══██╗██║ ██║██║ ██║ ██║
██████╔╝╚██████╔╝╚██████╔╝ ██║
╚═════╝ ╚═════╝ ╚═════╝ ╚═╝
╭──────────────────────────────────────────────────────────────────────╮
│ 🧹 MAC SYSTEM DATA CLEANUP │
╰──────────────────────────────────────────────────────────────────────╯
- Yarn Cache - Node.js package manager cache
- Xcode DerivedData - Xcode build artifacts and indexes
- iOS Simulator Data - Old simulator devices and logs
- CocoaPods Cache - iOS dependency manager cache
- Browser Caches - Arc, The Browser, Comet
- Homebrew Cache - Package manager downloads and old versions
- node-gyp Cache - Native addon build cache
- TypeScript Cache - Compiler cache
- Cypress Cache - E2E testing framework binaries
# Download the script
curl -O https://raw.githubusercontent.com/dikans/macos-system-data-clean-up/main/mac_system_data_cleanup.zsh
# Make it executable
chmod +x mac_system_data_cleanup.zsh
# Run it
./mac_system_data_cleanup.zshgit clone https://github.com/dikans/macos-system-data-clean-up.git
cd macos-system-data-clean-up
chmod +x mac_system_data_cleanup.zsh
./mac_system_data_cleanup.zsh./mac_system_data_cleanup.zshSee what would be deleted without actually removing anything:
./mac_system_data_cleanup.zsh --dry-run- Xcode & iOS Simulator
- Arc, The Browser, Comet
- Terminal sessions running
yarn,pod, orbrew
- macOS (tested on macOS 10.14+)
- zsh shell (default on macOS Catalina+)
- Admin permissions for some cache directories
- Scans your system for cache directories
- Shows sizes of what can be cleaned
- Prompts for confirmation on large deletions
- Safely removes approved caches
- Reports total space freed
The script uses du to calculate sizes, rm -rf for safe deletion, and never touches:
- Your personal files
- Application data
- System files
- Active projects
Contributions are welcome! Feel free to:
- Report bugs
- Suggest new features
- Add support for more caches
- Improve the UI
MIT License - feel free to use, modify, and distribute!
This script deletes cache files. While it's designed to be safe and only removes rebuildable caches:
- Always run with
--dry-runfirst to preview changes - Backup important data before running
- Close relevant applications to avoid corruption
- The author is not responsible for any data loss
Created by Dikans
Users typically free up:
- 5-15 GB for active developers
- 20-50 GB for iOS/React Native developers with simulators
- 1-5 GB for general users