# Clean Mac
**๐งน Deep Clean Your Mac with One Click**
[](https://github.com/tw93/clean-mac/releases) [](https://formulae.brew.sh/formula/clean-mac) [](https://github.com/tw93/clean-mac/blob/main/LICENSE) [](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 |
## 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