Repolode
Submit
tw93

tw93/Mole

Open-source macOS CLI (mo) for deep cleaning, app uninstalling, disk analysis, maintenance and live system status, with a separate native Mac app.

Open-source alternative to:CleanMyMacAppCleanerDaisyDisk

View on GitHubWebsite
Stars
72,196
Forks
2,551
Open issues
6
Last commit
19 hours ago

What is it?

Mole is a terminal toolkit for keeping a Mac clean and responsive. Its CLI, invoked as `mo`, removes caches, logs, and leftovers from uninstalled apps, and it can uninstall an app together with its LaunchAgents, preferences, and related files. An interactive disk analyzer finds large files and lets you drill into directories, while a status dashboard shows CPU, memory, disk I/O, network, and process activity.

The tool is designed for cautious use. Most destructive commands support `--dry-run` for previewing changes, cleanups can be protected with whitelists, and operations are logged to a history file. Some commands send deletions to the Trash by default, while `clean`, `purge`, and `installer` delete permanently.

Mole supports Intel and Apple Silicon Macs running macOS 12 or newer and is installed through Homebrew or a shell script. A separate native Mac app, sold by the same author, is distributed outside this repository, and a Windows CLI lives on a separate branch.

Key features

  • 01Deep cleanup of caches, logs, temporary files, and leftovers from removed apps
  • 02Smart app uninstaller that also removes related LaunchAgents and preferences
  • 03Interactive terminal disk analyzer with large-file detection
  • 04Project build artifact cleanup for folders like node_modules and target
  • 05Live system status dashboard with JSON output for scripting
  • 06Dry-run previews and operation history for safer use

Use cases

  • Reclaiming disk space on a developer Mac filled with caches and build artifacts
  • Removing an app completely along with its leftover support files
  • Finding which folders consume the most space before deleting anything
  • Monitoring CPU, memory, and disk activity from the terminal

Quick start

  1. 1

    Install via Homebrew (requires macOS 12 or newer)

    brew install mole
  2. 2

    Or run the official install script from the README

  3. 3

    Launch the interactive menu

    mo
  4. 4

    Preview a cleanup without deleting anything

    mo clean --dry-run

Things to know

  • Works only on macOS; the Windows version is a separate branch.
  • Licensed under GPL-3.0, a copyleft license that requires derivative works to remain open source.

Topics

#macos#cli#disk-cleaner#system-maintenance#uninstaller#disk-analyzer#shell#system-monitoring#analyzer#appcleaner

FAQ

What is Mole?
Open-source macOS CLI (mo) for deep cleaning, app uninstalling, disk analysis, maintenance and live system status, with a separate native Mac app. Mole is a terminal toolkit for keeping a Mac clean and responsive. Its CLI, invoked as `mo`, removes caches, logs, and leftovers from uninstalled apps, and it can uninstall an app together with its LaunchAgents, preferences, and related files. An interactive disk analyzer finds large files and lets you drill into directories, while a status dashboard shows CPU, memory, disk I/O, network, and process activity.
Is Mole free to use? What license does it have?
Mole is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is Mole still maintained?
Actively maintained. The last commit to Mole was on Oct 21, 2026.
What can I use Mole for?
Reclaiming disk space on a developer Mac filled with caches and build artifacts Removing an app completely along with its leftover support files Finding which folders consume the most space before deleting anything Monitoring CPU, memory, and disk activity from the terminal
How do I install Mole?
Install via Homebrew (requires macOS 12 or newer): brew install mole Or run the official install script from the README Launch the interactive menu: mo Preview a cleanup without deleting anything: mo clean --dry-run
Where can I get Mole?
The source code and installation instructions are on GitHub: https://github.com/tw93/Mole

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects