Skip to content
 
 

Latest commit

 

History

43 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mole Logo

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

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

Usage

mole               # Interactive main menu
mole clean         # Deep system cleanup
mole uninstall     # Interactive app uninstaller
mole --help        # Show help

Examples

Deep System Cleanup

$ 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

$ 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

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 feed them canned food if you'd like.

License

MIT License - feel free to enjoy and participate in open source.

About

🦑 Dig deep like a mole to clean your Mac. 🦑 像鼹鼠一样深ε…₯ζŒ–ζŽ˜ζ₯ζΈ…η†ζ‚¨ηš„ Mac

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages