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
```
> π **δΈδΌη¨η»η«―οΌ** ζ₯η [ε°η½δ½Ώη¨ζε](./GUIDE.md) δΊθ§£θ―¦η»ηεΎζζη¨
## Usage
```bash
mole # Interactive main menu
mole clean # Deep system cleanup
mole clean --dry-run # Preview cleanup (no deletions)
mole uninstall # Interactive app uninstaller
mole update # Update Mole to the latest version
mole --help # Show help
```
**Navigation:** Use arrow keys (β/β), Space to select, Enter to confirm, Q to quit or Ctrl+C to force exit.
## 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 | Typical 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 |
**Protect Important Files:** Create `~/.config/mole/whitelist` to preserve critical caches:
```bash
# View current whitelist
mole clean --whitelist
# Example: Protect Playwright browsers and build tools
echo '~/Library/Caches/ms-playwright*' >> ~/.config/mole/whitelist
```
## 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](https://github.com/tw93/mole/issues).
- I have two cats, you can