## Features at a Glance
- π¦ **Deep System Cleanup** - Remove hidden caches, logs, and temp files in one sweep
- π¦ **Thorough Uninstall** - 22+ locations cleaned vs 1 standard, beats CleanMyMac/Lemon
- π **Interactive Disk Analyzer** - Navigate folders like a file manager, find and delete large files instantly
- β‘οΈ **Fast & Lightweight** - Terminal-based, zero bloat, arrow-key navigation with pagination
- π§Ή **Massive Space Recovery** - Reclaim 100GB+ of wasted disk space
## Quick Start
**Friendly Tips:**
- β οΈ On mission-critical Macs, wait for Mole to matureβsafety first. **εε¦ζ€ Mac ε―Ήδ½ ιεΈΈιθ¦οΌθ―·η Mole ζηζΆεδ½Ώη¨**γ
- β οΈ Start with `--dry-run` to preview, enable `--whitelist` to protect caches.
- β€οΈ I'm not very tech-savvy οΌCheck [ε°η½δ½Ώη¨ζε](./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
mole # Interactive menu
mole clean # System cleanup
mole clean --dry-run # Preview mode
mole clean --whitelist # Manage protected caches
mole uninstall # Uninstall apps
mole analyze # Disk analyzer
mole update # Update Mole
mole remove # Remove Mole from system
mole --help # Show help
```
> π‘ **Homebrew users:** No updates showing? Run `brew update` first, then `brew upgrade mole`
## Features
### Deep System Cleanup
```bash
$ mole 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
====================================================================
```
**Whitelist Protection:**
```bash
mole clean --whitelist # Interactive - select caches to protect
# Default: Playwright browsers, HuggingFace models (always protected)
# Or edit: ~/.config/mole/whitelist
```
### Smart App Uninstaller
```bash
$ mole 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
$ mole analyze
π Analyzing: /Users/tw93
βββββββββββββββββββββββββββββββββββββββββββββββββββββββ
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
π‘ Navigate folders to find large files, press Delete key to remove
```
## FAQ
1. **Is Mole safe?** β Mole focuses on cleaning caches and logs, without touching app settings, user documents, or system files. You can run `mole clean --dry-run` to preview what will be removed before actually cleaning.
2. **How often should I clean?** β About once a month, or whenever you notice disk space running low.
3. **Can I protect specific caches?** β Yes. Run `mole clean --whitelist` to interactively choose which caches to keep. Some common ones like Playwright browsers and HuggingFace models are already protected by default.
## 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.
