Mole (tw93/Mole)

monitoring
Searching Database…

70.8K ·GitHub
What is this?Mole is a free, open-source command-line tool for macOS (mo) that cleans junk files, uninstalls apps, analyzes disk usage, runs system maintenance, and shows live hardware/network status, rolling CleanMyMac, AppCleaner, DaisyDisk, and iStat Menus-style features into one terminal binary.
Is this just a CLI, or is there a GUI app too?This repository is the free open-source CLI called 'mo'. There is also a separate paid native Mac app, Mole for Mac, with its own GUI for cleanup, app management, maintenance, and disk maps.
Does the purge command need any extra tools installed?mo purge uses the 'fd' tool when it is available on your system and automatically falls back to the built-in 'find' command otherwise.
Is it safe to just run the cleanup commands blindly?No — clean, uninstall, purge, installer, and remove subcommands can delete files, so the README recommends reviewing with --dry-run first before trusting them on your Mac.
Does it run on Windows?No, Mole is built for macOS; an experimental Windows version only exists in a separate 'windows' branch and isn't part of the main release.
Is there a catch with the GPL-3.0 license?You can modify and share it under the same GPL-3.0 terms, but if you fork Mole into another product you must give it a different name and credit Mole as the source.
What subcommands does mo provide?mo includes clean, uninstall, optimize, analyze, status, purge, and installer — covering cache cleanup, app removal, maintenance tasks, a terminal disk explorer, live system monitoring, rebuildable project artifact purging, and leftover installer-file cleanup.
Can I protect specific caches or apps from being touched?Yes, mo clean --whitelist and mo optimize --whitelist let you exclude caches, apps, or path patterns, saved to ~/.config/mole/whitelist.
What's the difference between the free CLI and Mole for Mac?Mole for Mac is a separate proprietary GUI app bundling cleanup, app management, maintenance, disk maps, and live status, with one license covering 2 Macs and a 14-day refund, unlike the free CLI here.
Can I trigger Mole from Raycast or Alfred?Yes, an install script sets up Raycast script commands and Alfred workflows with keywords clean, uninstall, optimize, analyze, and status for quick launching.
Creator
tw93
Size
257.5 MB
Stars
70.8K
Age
1y
Commits · 90 Days