Skip to content
/ Mole Public

๐Ÿน Dig deep like a mole to clean you Mac. ๅƒ้ผน้ผ ไธ€ๆ ทๆทฑๅ…ฅๆŒ–ๆŽ˜ๆฅๆธ…็†ไฝ ็š„ Mac

License

Notifications You must be signed in to change notification settings

tw93/Mole

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Mole

Dig deep like a mole to clean your Mac.

Stars Version License Commits Twitter Telegram

Mole - 95.50GB freed

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 ๆ›ดๆˆ็†Ÿๆ—ถๆฅไฝฟ็”จ๏ผŒๅฎ‰ๅ…จ็ฌฌไธ€

Install:

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

Or via Homebrew:

brew install tw93/tap/mole

Run:

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 mole 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

$ 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

$ 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

$ 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

  • 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.

  • How often should I clean? Once a month, or when disk space is running low.

  • 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.

  • Touch ID support? Mole uses sudo for privileges, so you'll get a password prompt unless you've configured Touch ID for sudo.

  • Enable Touch ID for sudo:

    sudo nano /etc/pam.d/sudo
    
    # Add this line below the comments at the top:
    auth sufficient pam_tid.so
    
    # Save: Ctrl+O, then exit: Ctrl+X

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
  • I have two cats, 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 you Mac. ๅƒ้ผน้ผ ไธ€ๆ ทๆทฑๅ…ฅๆŒ–ๆŽ˜ๆฅๆธ…็†ไฝ ็š„ Mac

Topics

Resources

License

Stars

Watchers

Forks

Languages