Skip to content

dikans/macos-system-data-clean-up

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🧹 Dikans Boot - Mac System Data Cleanup

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.

License Platform Shell

✨ Features

  • 🎨 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

🎬 Screenshot

  ██████╗ ██╗██╗  ██╗ █████╗ ███╗   ██╗███████╗
  ██╔══██╗██║██║ ██╔╝██╔══██╗████╗  ██║██╔════╝
  ██║  ██║██║█████╔╝ ███████║██╔██╗ ██║███████╗
  ██║  ██║██║██╔═██╗ ██╔══██║██║╚██╗██║╚════██║
  ██████╔╝██║██║  ██╗██║  ██║██║ ╚████║███████║
  ╚═════╝ ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝
  ██████╗  ██████╗  ██████╗ ████████╗
  ██╔══██╗██╔═══██╗██╔═══██╗╚══██╔══╝
  ██████╔╝██║   ██║██║   ██║   ██║   
  ██╔══██╗██║   ██║██║   ██║   ██║   
  ██████╔╝╚██████╔╝╚██████╔╝   ██║   
  ╚═════╝  ╚═════╝  ╚═════╝    ╚═╝   

╭──────────────────────────────────────────────────────────────────────╮
│                   🧹  MAC SYSTEM DATA CLEANUP                        │
╰──────────────────────────────────────────────────────────────────────╯

🧰 What Gets Cleaned

🔥 High Priority

  • 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

📦 Medium Priority

  • Browser Caches - Arc, The Browser, Comet
  • Homebrew Cache - Package manager downloads and old versions
  • node-gyp Cache - Native addon build cache

🔧 Optional

  • TypeScript Cache - Compiler cache
  • Cypress Cache - E2E testing framework binaries

🚀 Installation

Quick Install

# 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.zsh

Clone Repository

git 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

💻 Usage

Run Cleanup

./mac_system_data_cleanup.zsh

Dry Run (Preview Only)

See what would be deleted without actually removing anything:

./mac_system_data_cleanup.zsh --dry-run

Before Running

⚠️ Close these applications first:

  • Xcode & iOS Simulator
  • Arc, The Browser, Comet
  • Terminal sessions running yarn, pod, or brew

📋 Requirements

  • macOS (tested on macOS 10.14+)
  • zsh shell (default on macOS Catalina+)
  • Admin permissions for some cache directories

🎯 How It Works

  1. Scans your system for cache directories
  2. Shows sizes of what can be cleaned
  3. Prompts for confirmation on large deletions
  4. Safely removes approved caches
  5. 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

🤝 Contributing

Contributions are welcome! Feel free to:

  • Report bugs
  • Suggest new features
  • Add support for more caches
  • Improve the UI

📝 License

MIT License - feel free to use, modify, and distribute!

⚠️ Disclaimer

This script deletes cache files. While it's designed to be safe and only removes rebuildable caches:

  • Always run with --dry-run first to preview changes
  • Backup important data before running
  • Close relevant applications to avoid corruption
  • The author is not responsible for any data loss

🙏 Credits

Created by Dikans

📊 Typical Results

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

Releases

No releases published

Packages

No packages published

Languages