Clean Mac # Clean Mac **๐Ÿงน Deep Clean Your Mac with One Click** [![GitHub release](https://img.shields.io/github/release/tw93/clean-mac.svg)](https://github.com/tw93/clean-mac/releases) [![Homebrew](https://img.shields.io/badge/Homebrew-available-green.svg)](https://formulae.brew.sh/formula/clean-mac) [![License](https://img.shields.io/github/license/tw93/clean-mac.svg)](https://github.com/tw93/clean-mac/blob/main/LICENSE) [![macOS](https://img.shields.io/badge/macOS-10.14+-blue.svg)](https://github.com/tw93/clean-mac) [Installation](#installation) ยท [Usage](#usage) ยท [What Gets Cleaned](#what-gets-cleaned) ยท [Support](#support)
--- ## Features - ๐Ÿ”ฅ **More Thorough** - Cleans significantly more cache than other tools - โšก **Dead Simple** - Just one command, no complex setup or GUI - ๐Ÿ‘€ **Transparent & Safe** - Open source code you can review and customize - ๐Ÿ›ก๏ธ **Zero Risk** - Only touches safe cache files, never important data ## Installation ### Quick Install (Recommended) ```bash curl -fsSL https://raw.githubusercontent.com/tw93/clean-mac/main/install.sh | bash ``` ### Homebrew ```bash brew tap tw93/tap brew install clean-mac ``` ### Development ```bash # Clone and run locally git clone https://github.com/tw93/clean-mac.git cd clean-mac && chmod +x clean.sh && ./clean.sh ``` ## Usage ```bash clean # Daily cleanup (no password required) clean --system # Deep system cleanup (password required) clean --help # Show help information ``` ### Example Output ```bash ๐Ÿงน Clean Mac - Deep Clean Your Mac with One Click ================================================ ๐ŸŽ Detected: Apple Silicon (M-series) | ๐Ÿ’พ Free space: 45.2GB ๐Ÿš€ Mode: User-level cleanup (no password required) โ–ถ System essentials โœ“ User app cache (1.2GB) โœ“ User app logs (256MB) โœ“ Trash (512MB) โ–ถ Browser cleanup โœ“ Safari cache (845MB) โœ“ Chrome cache (1.8GB) โ–ถ Developer tools โœ“ npm cache cleaned โœ“ Docker resources cleaned โœ“ Homebrew cache (2.1GB) ๐ŸŽ‰ User-level cleanup complete | ๐Ÿ’พ Freed space: 8.45GB ๐Ÿ“Š Items processed: 342 | ๐Ÿ’พ Free space now: 53.7GB ``` ## What Gets Cleaned | Category | Items Cleaned | Safety Level | |----------|---------------|--------------| | **๐Ÿ—‚๏ธ System** | App caches, logs, trash, crash reports, QuickLook thumbnails | โœ… Safe | | **๐ŸŒ Browsers** | Safari, Chrome, Edge, Arc, Brave, Firefox, Opera, Vivaldi | โœ… Safe | | **๐Ÿ’ป Developer** | Node.js, Python, Go, Rust, Docker, Homebrew, Git, Cloud CLI | โœ… Safe | | **๐Ÿ› ๏ธ IDEs** | Xcode, VS Code, JetBrains, Android Studio, Unity, Figma | โœ… Safe | | **๐Ÿ“ฑ Apps** | Discord, Slack, Teams, Notion, 1Password, Steam, Epic Games | โœ… Safe | | **๐ŸŽ Apple Silicon** | Rosetta 2, M-series media cache, user activity cache | โœ… Safe | | **๐Ÿ”’ System Deep** | Font caches, iCloud sync, Adobe, VMs, system logs | โš ๏ธ --system flag |
**๐ŸŒ Web Browsers** - Safari cache & storage - Chrome/Chromium cache - Edge, Arc, Brave cache - Firefox, Opera cache **๐Ÿ’ป Development Tools** - npm, yarn, pnpm cache - pip, poetry, conda cache - Docker images & containers - Xcode derived data **๐Ÿ“ฑ Applications** - Discord, Slack cache - VS Code extensions cache - JetBrains IDE logs - Steam, Epic Games cache **๐ŸŽ Apple Silicon** - Rosetta 2 cache - M-series optimizations - iOS device backups - Simulator cache
## Support If Clean Mac has been helpful to you: - **Star this repository** and share with fellow Mac users - **Report issues** or suggest new cleanup targets - I have two cats, if you think Clean helps you, you can feed them canned food ๐Ÿฅฉ๐Ÿค ## License MIT License ยฉ [tw93](https://github.com/tw93) - Feel free to enjoy and contribute to open source