mrkeyoor.com_
Tue 01 Sept 17:41 UTC
Dev Toolsevaluationupdated 26 Aug 2026

Mole review

Mole is a macOS command-line toolkit for cleaning storage, uninstalling applications, inspecting disk use, refreshing caches and services, and watching system health. It replaces several narrow maintenance utilities with one free, open-source CLI, while an optional paid native Mac app provides a graphical interface.

+613stars / 7d
Verdict

Our build completed in 19 seconds, and all 4 supplied Go tests passed in 10 seconds. Mole is unusually thoughtful for a deletion-capable CLI: dry runs, confirmations, whitelists, history, and conservative skipping make it easier to trust than a blind cleanup script. Use it if you want one terminal tool for routine Mac maintenance, but treat its first run as an audit and do not mistake a successful Linux build for proof that every macOS cleanup rule is safe for your machine.

We ran it

Install✓ · 98s44 packages
Build✓ · 19s
Tests✓ · 10s4 passed · 0 failed of 4 (go test)
Repo237 files~70,187 lines of source · 6.3 MB · 6 CI workflows · tests dir

Answers from our run

Does Mole build from source?

Dependencies installed in 98 seconds (44 packages), and the build succeeded in 19 seconds. We cloned commit ef2485a into a clean Debian container with 3 CPUs and no project-specific setup.

Do Mole's tests pass?

Yes: 4 of 4 passed when we ran the project's own test command (go test). Some failures need services or credentials a bare container does not have.

Who should not use Mole?

Windows or Linux users, because macOS is the supported platform and Windows support is experimental

What are the alternatives to Mole?

Pearcleaner, mac-cleanup-sh, ncdu. Our build completed in 19 seconds, and all 4 supplied Go tests passed in 10 seconds.

Setup5/5Homebrew is one command; our clean install also succeeded
Docs5/5Clear commands, safety guidance, examples, and install options
Community5/564,960 stars, same-day push, and a release four days ago
Maturity4/5Strong safeguards and CI, but only 4 tests ran in our sandbox

Discussed on

  1. hnMole – Deep clean and optimize your Mac33 points
  2. hnShow HN: Mole – Deep clean and optimize your Mac6 points
  3. hnMole: Deep clean and optimize your Mac4 points
  4. hnTw93/Mole: Deep clean and optimize your Mac3 points
  5. hnMole (macOS App)3 points

Who it’s for

Mac users comfortable reviewing cleanup plans in a terminal
Developers who accumulate package caches, build artifacts, and Xcode data
Administrators who want repeatable cleanup with dry runs and operation history
People who prefer a GPL-3.0 CLI over a paid all-in-one maintenance suite

Who it’s NOT for

Windows or Linux users, because macOS is the supported platform and Windows support is experimental
Anyone wanting a fully graphical free tool, because the native Mac app costs $19
Users unwilling to inspect deletion plans, because several commands can remove files
Teams needing independently verified cleanup effectiveness or performance benchmarks, which the supplied evidence does not provide

Setup reality

In our Debian sandbox, installation succeeded in 98 seconds with 44 packages installed, the build succeeded in 19 seconds, and all 4 Go tests passed in 10 seconds. That confirms the repository can be installed, compiled, and tested in a clean environment, but it does not validate Mole's actual macOS cleanup behavior because the product is built for macOS and our container was unprivileged Linux. For a Mac user, the README presents the simpler path, brew install mole, while the script installer, user-owned prefix, permissions, and possible administrator prompts add choices that deserve attention before running destructive commands.

One Mac maintenance command replaces several narrow utilities

Mole is an ambitious command-line toolbox for a familiar Mac problem: storage and system maintenance are scattered across app uninstallers, disk visualizers, cache cleaners, and menu-bar monitors. Its mo command brings cleaning, uninstalling, disk analysis, optimization, project-artifact purging, installer removal, and live resource status into one interface. The free CLI is GPL-3.0 software; the separate native app costs $19 for 2 Macs and includes lifetime updates. That split is clear rather than coy, and the README explicitly promises that the CLI remains free and open source.

The project also looks alive, not merely popular. It had 64,960 GitHub stars in the supplied snapshot, was pushed on August 26, 2026, and shipped V1.52.0 on August 22. The reported open-issue count is 0. Zero issues can reflect responsive maintenance, a recently cleared tracker, or limited issue usage, so it should not be treated as proof of perfection. Combined with a same-day push, a release 4 days earlier, and 6 CI workflow files, however, it is a stronger health signal than star count alone.

Our clean build passed, but it did not exercise macOS cleanup

We cloned commit ef2485a into an unprivileged Debian container with 3 CPUs and 8 GB of RAM. Installation succeeded in 98 seconds and installed 44 packages. The repository then built successfully in 19 seconds. Its Go test run finished in 10 seconds, with 4 passing and 0 failing tests. Those are our measurements, not numbers copied from the project, and they show that the checked-out source was buildable in a fresh environment.

The limits of that result matter. Mole targets macOS, while our box used golang:1.24-bookworm, so we did not validate deletion rules against a real Mac, confirm Touch ID setup, observe GPU monitoring, or measure reclaimed space. The checkout contained 237 files, roughly 70,187 source lines, occupied 6.3 MB, had a tests directory, and lacked a Dockerfile. A 4-test green run is encouraging but narrow beside that codebase size. It supports confidence in basic build health, not a claim that every cleanup path is covered.

Safety controls are the strongest reason to choose Mole

Cleanup software earns trust through restraint, and Mole documents several useful brakes. mo clean --dry-run, mo uninstall --dry-run, and equivalent previews for optimization, purging, and installer cleanup let you inspect plans before files move. The tool validates paths, protects shared and system-owned locations, asks for confirmation, and says it skips work when safety cannot be established. Whitelists protect selected caches and maintenance rules, while mo history and JSON history expose prior operations from the log under ~/Library/Logs/mole/operations.log.

The breadth is practical for developer Macs. mo purge targets build artifacts, mo installer finds old installer files, and mo analyze /Volumes can limit inspection to external drives. The live dashboard covers CPU, GPU, memory, disk, and network status. Installation is also flexible: Homebrew is a single command, while the script accepts a release such as 1.51.0, the development branch, or a user-owned prefix like $HOME/.local/bin. The documentation warns that main is unreleased code and that the legacy latest alias surprisingly points there, a detail that can prevent accidental upgrades to rough builds.

Broad cleanup still requires judgment

No safety layer makes cache deletion risk-free. Removing caches can make applications rebuild data, trigger fresh downloads, or slow the next launch, and uninstall matching can be difficult when several applications share support files. Mole's refusal and skip behavior is preferable to aggressive guessing, but users still need to read each dry-run plan. The screenshot and shortened examples illustrate possible results, not measured outcomes from our test, so claims about reclaiming gigabytes should be treated as workload-dependent rather than guaranteed.

Permissions add another rough edge. The default script destination is /usr/local/bin, which may ask for an administrator password, and commands touching system-owned files can still request elevated access even if Mole itself lives under $HOME/.local/bin. The optional mo touchid changes how sudo authentication works, so it deserves the same scrutiny as any security-related convenience. Windows users should also look elsewhere: the README labels that version experimental and keeps it on a separate branch. On macOS, start with the stable V1.52.0 release rather than main.

It fits as an operator-controlled tool, not unattended automation

Mole belongs on a developer workstation or an administrator's Mac as an interactive maintenance layer. It can complement backups, endpoint management, and ordinary package-manager hygiene, but it should not replace any of them. Its strongest workflow is simple: install the stable release, run a dry preview, protect valuable caches with a whitelist, execute only reviewed categories, and inspect history afterward. The JSON history output may help record maintenance, yet the README evidence does not establish a policy engine or fleet orchestration system.

Alternatives are better when the scope is narrower. Pearcleaner is the more natural pick for someone who mainly wants a native graphical uninstaller. mac-cleanup-sh suits users who want a smaller shell-based cleanup routine. ncdu is a safer conceptual choice when the task is only to locate large directories, because it focuses on disk inspection rather than combining inspection with broad Mac maintenance. Mole wins when one CLI covering 7 core command areas is genuinely useful, provided the operator values review over one-click deletion.

The sensible default is preview first, then keep it

Mole combines unusually good documentation with visible safety boundaries and current maintenance. The successful 19-second build and 4-of-4 test result make the source easier to trust, while the limited test count and Linux environment keep that confidence properly bounded. For terminal-friendly Mac users, it is worth trying through Homebrew and evaluating entirely in dry-run mode before approving cleanup. If its proposed paths match your expectations, the consolidated commands, whitelists, and audit history make it a credible long-term utility rather than a disposable cleanup script.

Alternatives

ProjectWhat it isPick it when
PearcleanerA free, open-source native macOS app uninstaller and cleanup utility.you want a graphical Mac interface focused mainly on removing apps and leftovers
mac-cleanup-shA shell-based macOS cleanup script aimed at caches and development clutter.you want a smaller cleanup-focused script instead of an interactive all-in-one toolkit
ncduA fast terminal disk-usage browser for finding where space went.you only need to inspect disk usage and want a mature cross-platform tool that does not attempt broad Mac maintenance

What people are saying

  1. [velocity-scout] tw93/Mole
  2. [hackernews] Show HN: Mole – Deep research agent for your terminal
  3. [techcrunch-ai] Discovered Materials is playing AI whack-a-mole to hunt cooler chips

Sources

  1. Mole GitHub repository
  2. Mole for Mac homepage

More dev tools reviews

workmux · v2rayNG · SecLists · hashcat · eslint · fastfetch · the whole board →