Mole/README.md

Clean Mac

🧹 Deep Clean Your Mac with One Click

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)

curl -fsSL https://raw.githubusercontent.com/tw93/clean-mac/main/install.sh | bash

Homebrew

brew tap tw93/tap
brew install clean-mac

Development

# Clone and run locally
git clone https://github.com/tw93/clean-mac.git
cd clean-mac && chmod +x clean.sh && ./clean.sh

Usage

clean              # Daily cleanup (no password required)
clean --system     # Deep system cleanup (password required)
clean --help       # Show help information

Example Output

🧹 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 feed them canned food 🥩🍤

License

MIT License © tw93 - Feel free to enjoy and contribute to open source.