Mole
๐ฆก Dig deep like a mole to clean your Mac.
## Highlights
- ๐ฆก **Deep System Cleanup** - Remove hidden caches, logs, and temp files in one sweep
- ๐ฆ **Smart Uninstall** - Complete app removal with all related files and folders
- โก๏ธ **Fast Interactive UI** - Arrow-key navigation with pagination for large lists
- ๐งน **Massive Space Recovery** - Reclaim 100GB+ of wasted disk space
## Installation
```bash
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
```
## Usage
```bash
mole # Interactive main menu
mole clean # Deep system cleanup
mole uninstall # Interactive app uninstaller
mole --help # Show help
```
## Examples
### Deep System Cleanup
```bash
$ mole clean
Starting user-level cleanup...
โถ System essentials
โ User app cache (28 items) (45.2GB)
โ User app logs (15 items) (2.1GB)
โ Trash (12.3GB)
โถ Browser cleanup
โ Chrome cache (8 items) (8.4GB)
โ Safari cache (2.1GB)
โ Arc cache (3.2GB)
โถ Extended developer caches
โ Xcode derived data (9.1GB)
โ Node.js cache (4 items) (14.2GB)
โ VS Code cache (1.4GB)
โถ Applications
โ JetBrains cache (3.8GB)
โ Slack cache (2.2GB)
โ Discord cache (1.8GB)
====================================================================
๐ CLEANUP COMPLETE!
๐พ Space freed: 95.50GB | Free space now: 223.5GB
๐ Files cleaned: 6420 | Categories processed: 6
====================================================================
```
### 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
โ Cleaned 45 related files
====================================================================
๐ UNINSTALLATION COMPLETE!
๐๏ธ Apps uninstalled: 1 | Space freed: 12.4GB
====================================================================
```
## What Mole Cleans
| Category | Targets | Recovery |
|----------|---------|----------|
| ๐๏ธ **System** | App caches, logs, trash, crash reports | 20-50GB |
| ๐ **Browsers** | Safari, Chrome, Edge, Arc, Firefox cache | 5-15GB |
| ๐ป **Developer** | npm, pip, Docker, Homebrew, Xcode | 15-40GB |
| ๐ฑ **Apps** | Slack, Discord, Teams, Notion cache | 3-10GB |
## What Mole Uninstalls
| Component | Files Removed | Examples |
|-----------|--------------|----------|
| ๐ฏ **App Bundle** | Main .app executable | `/Applications/App.app` |
| ๐ **Support Data** | App-specific user data | `~/Library/Application Support/AppName` |
| ๐พ **Cache Files** | Temporary & cache data | `~/Library/Caches/com.company.app` |
| โ๏ธ **Preferences** | Settings & config files | `~/Library/Preferences/com.app.plist` |
| ๐ **Logs & Reports** | Crash reports & logs | `~/Library/Logs/AppName` |
| ๐ฆ **Containers** | Sandboxed app data | `~/Library/Containers/com.app.id` |
## Support
If Mole helps you recover disk space:
- โญ **Star this repository** and share with fellow Mac users
- ๐ **Report issues** via GitHub Issues
- ๐ I have two cats. You can