## Features
- **Deep System Cleanup** - Cleans way more junk than CleanMyMac/Lemon - caches, logs, temp files
- **Thorough Uninstall** - Scans 22+ locations to remove app leftovers, not just the .app file
- **Interactive Disk Analyzer** - Navigate folders with arrow keys, find and delete large files quickly
- **Fast & Lightweight** - Terminal-based with arrow-key navigation, pagination, and Touch ID support
## Quick Start
**Tips:**
- If your Mac is mission-critical, consider waiting for Mole to mature further - safety first
- 如果这台 Mac 对你非常重要，建议等 Mole 更成熟时来使用，安全第一
- Not tech-savvy? Check out the [小白使用指南](./GUIDE.md)
**Install:**
```bash
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
```
Or via Homebrew:
```bash
brew install tw93/tap/mole
```
**Run:**
```bash
mo # Interactive menu
mo clean # System cleanup
mo clean --dry-run # Preview mode
mo clean --whitelist # Manage protected caches
mo uninstall # Uninstall apps
mo analyze # Disk analyzer
mo update # Update Mole
mo remove # Remove Mole from system
mo --help # Show help
mo --version # Show installed version
```
> If the command is not found, run `mo update` once to upgrade to the latest version.
>
> Recommended: Start with `mo clean --dry-run` to preview what will be deleted, use `mo clean --whitelist` to protect important caches
## Features in Detail
### Deep System Cleanup
```bash
$ mo clean
▶ System essentials
✓ User app cache (45.2GB)
✓ User app logs (2.1GB)
✓ Trash (12.3GB)
▶ Browser cleanup
✓ Chrome cache (8.4GB)
✓ Safari cache (2.1GB)
▶ Developer tools
✓ Xcode derived data (9.1GB)
✓ Node.js cache (14.2GB)
▶ Others
✓ Dropbox cache (5.2GB)
✓ Spotify cache (3.1GB)
====================================================================
CLEANUP COMPLETE!
Space freed: 95.50GB | Free space now: 223.5GB
====================================================================
```
### Smart App Uninstaller
```bash
$ mo uninstall
Select Apps to Remove
═══════════════════════════
▶ ☑ Adobe Creative Cloud (12.4G) | Old
☐ WeChat (2.1G) | Recent
☐ Final Cut Pro (3.8G) | Recent
Uninstalling: Adobe Creative Cloud
✓ Removed application # /Applications/
✓ Cleaned 52 related files # ~/Library/ across 12 locations
- Support files & caches # Application Support, Caches
- Preferences & logs # Preferences, Logs
- WebKit storage & cookies # WebKit, HTTPStorages
- Extensions & plugins # Internet Plug-Ins, Services
- System files with sudo # /Library/, Launch daemons
====================================================================
UNINSTALLATION COMPLETE!
Space freed: 12.8GB
====================================================================
```
### Disk Space Analyzer
```bash
$ mo analyze
Analyzing: /Users/You
═══════════════════════════════════════════════════════
Total: 156.8GB
├─ 📁 Library 45.2GB
│ ├─ 📁 Caches 28.4GB
│ └─ 📁 Application Support 16.8GB
├─ 📁 Downloads 32.6GB
│ ├─ 📄 Xcode-14.3.1.dmg 12.3GB
│ ├─ 📄 backup_2023.zip 8.6GB
│ └─ 📄 old_projects.tar.gz 5.2GB
├─ 📁 Movies 28.9GB
│ ├─ 📄 vacation_2023.mov 15.4GB
│ └─ 📄 screencast_raw.mp4 8.8GB
├─ 📁 Documents 18.4GB
└─ 📁 Desktop 12.7GB
```
## FAQ
1. **Is Mole safe?** – Mole only cleans caches and logs, it doesn't touch app settings, user documents, or system files. Run `mo clean --dry-run` first to preview what will be removed.
2. **How often should I clean?** – Once a month, or when disk space is running low.
3. **Can I protect specific caches?** – Yes. Run `mo clean --whitelist` to choose which caches to keep. Common ones like Playwright browsers and HuggingFace models are already protected.
4. **Does Mole support Touch ID?** – Mole uses `sudo` for privileges, so you'll get a password prompt unless you've configured Touch ID for sudo.
## Support
- **Star this repo** if Mole helped you recover disk space
- **Share with friends** who need to clean their Macs
- **Report issues** via [GitHub Issues](https://github.com/tw93/mole/issues)
- I have two cats, feed them canned food if you'd like
## License
MIT License - feel free to enjoy and participate in open source.
