explaingit

tw93/mole

🔥 Hot51,829ShellAudience · developerComplexity · 2/5ActiveLicenseSetup · easy

TLDR

A free command-line Mac maintenance tool that cleans caches, uninstalls apps completely, analyzes disk usage, and monitors system performance, replacing several paid utilities.

Mindmap

mindmap
  root((mole))
    What it does
      Clean caches
      Uninstall apps
      Analyze disk
      Monitor system
    Key commands
      clean
      uninstall
      analyze
      optimize
      status
    Use cases
      Free Mac cleanup
      Remove app traces
      Find disk hogs
      Check performance
    Tech stack
      Shell
      Homebrew
      macOS
    Audience
      Developers
      Power users
      Terminal users

Things people build with this

USE CASE 1

Clean up accumulated cache files and system logs to free up disk space on your Mac.

USE CASE 2

Completely remove an application and all its hidden preference files, launch agents, and support data.

USE CASE 3

Visualize where disk space is being used and navigate folders to find and delete large files.

USE CASE 4

Monitor CPU, memory, disk, and network activity in a live dashboard from the terminal.

Tech stack

ShellHomebrewmacOS

Getting it running

Difficulty · easy Time to first run · 5min
Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

Mole is a command-line tool for macOS that combines the functionality of several popular Mac maintenance utilities into a single program. Instead of buying and running separate apps like CleanMyMac for cache cleaning, AppCleaner for thorough app removal, DaisyDisk for visualizing disk space, and iStat Menus for system monitoring, Mole handles all of these from the terminal in one unified tool. The tool works through a set of commands you run in the terminal. The clean command scans and removes accumulated cache files, browser leftovers, developer tool caches, and system logs that pile up over time. The uninstall command removes an application along with all its hidden files scattered across the system, such as preferences, launch agents, application support data, and crash logs, which ordinary app deletion misses. The analyze command shows you a visual breakdown of where your disk space is going, letting you navigate into folders to find large files. The optimize command rebuilds system caches and refreshes services like Spotlight indexing. The status command shows a live dashboard of CPU, memory, disk, and network activity. Each destructive command supports a dry-run mode that shows you exactly what would be removed without actually deleting anything. You would use Mole when your Mac is running low on storage or feeling sluggish, or when you want to completely remove an application and all its traces. It is aimed at developers and power users who are comfortable with a terminal and prefer a free, open-source alternative to paid Mac maintenance apps. The tool is written in Shell and distributed as a single binary installable via Homebrew.

Copy-paste prompts

Prompt 1
How do I use mole to safely preview what cache files will be deleted before actually removing them?
Prompt 2
Show me how to use mole's uninstall command to completely remove an app and all its hidden files from my Mac.
Prompt 3
How can I use mole to find which folders are taking up the most disk space on my Mac?
Prompt 4
What's the difference between using mole's clean command versus manually deleting files from the Library folder?
Prompt 5
How do I install mole via Homebrew and run it from the terminal on macOS?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.