1. Download and try

Click Download and try free. Drag Mole into Applications and launch it. Each tool works twice without a license.

2. Buy a license

From the homepage, click the buy button. You will land on the secure Dodo Payments checkout page.

1. Fill in Contact Information: your name, a regular email inbox, and phone. The license key will be sent there. Before paying, double-check the spelling. Avoid forwarding or privacy relay addresses such as @duck.com; Dodo Payments license emails may not reach them.
2. Fill in Billing Address: country, city, region, postal code.
3. Click Continue to Payment.
4. Pick a payment method: Card, Apple Pay, Google Pay, WeChat, or Cash App.
5. Confirm payment. The license key arrives in your inbox within seconds.

3. Activate Mole

1. Open the email from Dodo Payments and copy the license key.
2. Open Mole. Press Cmd + Shift + L (or open the Mole menu in macOS's menu bar and choose License…).
3. Paste the key and click Activate. Mole removes accidental spaces and line breaks automatically.
4. You will see All tools unlocked. That is it.

4. Switch to a new Mac

Each license works on up to 2 Macs at the same time. To move it: open Mole on the old machine, press Cmd + Shift + L, click Deactivate this device. Then activate on the new machine with the same key.

5. Refund and invoices

If Mole is not what you wanted, email hi@mole.fit within 14 days with your Payment ID or purchase email. See the Refund Policy for full terms.

Please include a short note in the email about what felt difficult or did not meet expectations. It helps me process the request faster and keep improving Mole.

Dodo Payments generates a receipt automatically after each purchase. For a formal invoice (with a company name or VAT info), email hi@mole.fit within 30 days of purchase.

6. Settings and shortcuts

Press Cmd + , to open Settings. Settings has three tabs.

General covers the basics:

• Language sets the interface language after a relaunch.
• Launch at Login starts Mole automatically when you log in.
• Hide Dock Icon runs Mole as a menu-bar-only app.
• License shows activation status and lets you activate, deactivate, switch devices, or recover from a device-limit state.
• Full Disk Access shows permission status and opens the right System Settings pane.

Maintenance covers cleanup behavior:

• Cache Removal decides how caches are handled: Permanent frees space immediately, while Trash stays recoverable.
• Protected Items opens the whitelist manager; anything you protect is skipped by future scans.
• Optimize Dock Refresh toggles whether Optimize includes a Dock restart in its default run.

Menu Bar controls the menu bar HUD and its quick tools:

• Menu Bar Monitor keeps live metrics, a compact icon, or a moving runner in the macOS menu bar.
• Runner style picks the character: Mole, Cat, Rabbit, or Squirrel.
• Visible metrics chooses what shows up on the runner's two lines from CPU, Memory, Temperature, Disk, and Network.
• Fan controls appear on supported Macs with Auto, Cool, and Quiet modes.
• Shortcuts for Menu Bar Toggle, Keep Screen On, and Clean Screen are recorded here; none have a default.
• Clean Screen Input Lock uses macOS Accessibility to block input during a Clean Screen session; the toggle links to the Accessibility pane.
• Privacy Signal Notifications alerts you when the camera or microphone starts being used.

Shortcuts:

• Cmd + , open Settings
• Cmd + Shift + L open License panel
• Esc close any overlay (Settings, License, Doctor, review panels)
• Menu Bar Toggle, Keep Screen On, and Clean Screen each take a custom shortcut you record in Settings → Menu Bar.

7. Tips for daily use

The earlier sections cover setup and operation. These notes match Mole to how you actually work.

Menu bar shortcuts

Three optional global shortcuts live in Settings → Menu Bar: Menu Bar Toggle, Keep Screen On, and Clean Screen. None ship with a default, so the hotkeys only fire after you record one. Click into a field, press the combination, then press Enter; Mole replaces any previous binding for that action.

Picks that work well: ⌘⇧O for Menu Bar Toggle to peek at CPU and memory in passing; a function key or ⌥⇧K for Keep Screen On while presenting or downloading; ⌃⌥C for Clean Screen before a screen share or focused writing session.

Optimize cadence

Optimize quietly skips tasks when it could disturb device state you may be relying on: an active VPN, Bluetooth HID or audio, or an external display or audio device. Skipped tasks surface a reason in the result list so you can review what ran. The Dock restart adds a 7-day cooldown and tells you how many days since it last ran.

Suggested rhythm: run Optimize when memory pressure stays high or apps open slowly, not as a daily habit. Between Optimize runs, the Doctor tab is a lighter health checkpoint.

Cache removal mode

Permanent (the default) frees space immediately and the scan results cannot be restored. Trash sends everything to the macOS Trash, so you can drag items back to the original location if a cleaned cache turns out to be more important than expected.

Trash mode is a calm safety net for the first few cleanups, or whenever a category is unfamiliar. Open Docs → Clean to see which sections are auto-clean and which are review-only.

8. Run Doctor inside Mole

From the menu bar pick Help → Run Doctor…. Mole gathers a short report covering your Mac, permissions, recent operations, and environment. Click Copy Report to share it in chat, or Open GitHub Issue to land in a bug form with everything pre-filled.

Full Disk Access is missing

Mole needs Full Disk Access to scan caches under ~/Library and system locations. Open System Settings → Privacy & Security → Full Disk Access, enable Mole, and relaunch the app. Mole only reads from these locations; it never sends file contents anywhere.

Memory pressure is high

macOS reports elevated memory pressure when active memory plus compressed memory crowd out the cache. Close unused apps (especially browsers with many tabs and large Electron tools). Mole's Status tab lists the top processes by CPU and memory if you want to see who is using the most.

Disk is almost full

Once your startup disk crosses 90% used, macOS starts swapping and slowing down. Open the Clean tab to recover caches, logs, and trash. For one-off large folders, the Analyze tab visualises space by directory so you can spot the heavy hitters.

Battery health is low

Mole flags this when maximum capacity drops below 80% or the battery passes 1000 charge cycles. There is no software fix for a worn battery: check the exact reading under System Settings → Battery → Battery Health, then book Apple service if runtime no longer holds up. The Status tab keeps the same reading visible.

Mole's operations log can't be written

Mole writes a per-operation log at ~/Library/Logs/mole/operations.log. If the disk is full or that directory is unwritable, the log fails silently. Free up some space, then quit and reopen Mole; the doctor report will turn green on the next run.

Recent operations failed

A failure usually means one path inside a clean or uninstall batch was protected by macOS, blocked by another app, or already gone by the time Mole reached it. Open the tab where the failure happened (Clean, Uninstall, Optimize) and inspect the details overlay; each failed row carries a reason.

9. Report a problem

Before filing anything, check open issues first; someone may have hit the same thing.

Mac app bug or crash

Run Doctor first (section 8 above). Click Open GitHub Issue in the Doctor overlay to land in a bug form with your system report pre-filled. If you prefer to file manually, copy the report and paste it into the form.

Mac app feature idea

Open the feature request form. Describe the problem the feature would solve, not just the feature itself.

CLI bug or suggestion

The Mole CLI is a separate open-source project. File CLI-specific issues in the CLI issue tracker. Include your macOS version and mo version output.

License, payment, refund, or private details

Email hi@mole.fit with your purchase email, Payment ID, and approximate payment time.

Overview

Mole has two interfaces with the same cleanup scope, safety rules, and protection lists. The CLI is free, open source, and MIT-licensed. The Mac app is a native SwiftUI companion with a $9 launch early-bird license until June 15, 2026; the regular one-time price is $19 from June 16. It uses native execution for the Mac workflows; the CLI adds a few terminal-only commands.

Mac App

Installation

Download the DMG from the home page, or install via Homebrew: brew install --cask mole-app.

Clean (Earth)

Scans ten categories: app caches, system caches and logs, developer tools (Xcode, npm, pip, Gradle), AI tools (ChatGPT, Claude, Codex, Copilot, Cursor, Antigravity), browsers (Chrome, Edge, Arc, Safari, Firefox), cloud storage clients, design tools (Adobe, Figma, Sketch), communication apps (Slack, Discord, WeChat, Zoom), and miscellaneous temp files. The Trash is listed separately at the end.

The review list is sorted by deletion impact: regenerable caches appear first, user-visible state last, Trash always at the bottom. Hardlink-aware sizing means files shared across tools (uv, pnpm) are not double-counted. Default deletion is permanent so the freed bytes match the headline. One toggle in Settings routes everything through the system Trash instead.

A small set of categories is review-only by default: package caches with real rebuild cost (npm, yarn, pnpm, bun, CocoaPods, Gradle, Maven) and developer state worth a glance before clearing. Auto-clean items arrive pre-checked; review-only ones are visible for context but stay unchecked. The Cache Removal toggle in Settings routes everything through the Trash if you prefer a recoverable safety net.

Software (Mars)

Software combines app updates, startup management, and uninstall cleanup. The Updates view checks Sparkle, Homebrew Cask and Formula, and Mac App Store apps, then installs supported updates in place or opens the App Store when macOS requires that handoff.

The Startup view lists Login Items, Launch Agents, Launch Daemons, and background items. You can disable supported entries, reveal their files, or jump to System Settings for Apple-managed items.

For uninstall, pick apps to remove. Mole finds leftover files in fifteen-plus Library subdirectories, including Application Support, Caches, Preferences, Logs, Launch Agents, Launch Daemons, Login Items, Containers, Group Containers, Saved Application State, and Input Methods. Dock entries are cleaned automatically, and personal-looking data triggers a warning before deletion.

Updates ship in-app where possible: Sparkle and Homebrew Cask installs run inside Mole; Mac App Store updates go through CommerceKit and fall back to the App Store app on auth or timeout issues; other apps open so their own updater can take over. Cmd-click adds rows to a multi-uninstall batch, and any per-app failure stays in the list for retry.

Root-owned /Applications/*.app bundles need one administrator confirmation on first removal in a session; later removals reuse the same authorization until you quit Mole. The Startup view toggles login items and validated LaunchAgents / LaunchDaemons directly when it can match them to a stable launchd service; entries managed by macOS background task management without a clear handle are routed to the matching System Settings pane instead.

Optimize (Mercury)

Default maintenance tasks run with one tap. Non-admin tasks run silently; admin tasks are batched behind one prompt when needed.

Tasks include: rebuild Quick Look, Spotlight when safe, font cache and Launch Services garbage collection; vacuum SQLite stores; clean saved application state, quarantine events and notification history; repair broken preferences, Launch Agents and shared file lists; optional Dock refresh; audit login items; and run periodic maintenance.

Safety gates skip tasks when conditions are unsafe: font cache rebuild is skipped when browsers are open, Spotlight reindex is skipped on battery power, and DNS or network-stack resets are not part of the default maintenance set.

Optimize also skips device-touching tasks when an active VPN, Bluetooth HID or audio, or an external display or audio device is detected; skipped tasks list a reason in the result panel so you can see what ran. The Dock restart adds a 7-day cooldown and reports the days since its last run, so it never thrashes the Dock on back-to-back invocations.

Analyze (Jupiter)

A treemap visualization of your entire disk. Drill down into any directory to see size at every level. Right-click any entry to move it to the Trash or reveal it in Finder, without leaving the map view.

Entries that could not be sized (permission-restricted folders, TCC-gated containers) are surfaced with a retry option instead of being silently dropped. Protected navigational roots (/, /Users, /Applications) cannot be trashed. Disk scan results are cached for 24 hours for fast re-entry.

Single-click a directory in the treemap to drill in; the breadcrumb row above the map jumps back to any ancestor. Hover any row in the list view to surface a trash icon for that path, and right-click for Move to Trash with confirmation. Block area in the treemap is proportional to byte size, so the biggest space hogs always sit visually largest.

Status (Sun)

Eight live tiles on one bento dashboard: a Health hero with score and uptime, then CPU, GPU, Memory, Battery (or Thermal on desktops without a battery), Disk, Network, and a flex Fans or Thermal tile depending on hardware. Each metric carries a 60-second sparkline, and supported Macs expose fan controls for Auto, Cool, and Quiet modes.

The process list below the grid updates every second. Click any column header (Name, CPU, Memory) to sort. Click a row to pin it; pinned processes stay at the top across refreshes so you can watch a specific app without losing it in the scroll.

All five columns (Name, PID, CPU, Power, Memory) sort on click; click again to flip direction. Right-click a row for Pin/Unpin (kept across refreshes and app restarts), Terminate (a graceful TERM with a forced KILL fallback), and Copy Executable Path. The Battery tile's top-drain row links directly to that process in the explanation sheet.

Menu bar HUD

An optional always-on monitor in the macOS menu bar. Choose live metrics, a compact icon, or a small runner animation whose motion follows system load. Pick the runner character from Mole, Cat, Rabbit, or Squirrel. The popover shows a Health hero (score, chip, memory, macOS, uptime), hardware tiles, fan controls where supported, top five CPU processes, and a Clean Watch lifetime summary.

Quick tools live at the bottom of the popover: privacy signal indicators light up when the camera or microphone is in use, Keep Screen On has a duration menu (1h / 4h / Until I stop), Clean Screen blanks the desktop for focused work with an optional Accessibility-gated input lock, and Eject Volume safely unmounts external drives. A right-click quick menu opens any tool, a customizable global keyboard shortcut summons Mole from anywhere, and hiding the Dock icon turns it into a menu-bar-only app. Configure everything under Settings → Menu Bar.

Display Mode picks between the runner animation and a Metrics view of two configurable rows. Each row can independently show CPU, Memory, Temperature, Disk, or Network. The runner character (Mole, Cat, Rabbit, Squirrel) is purely visual and never changes which metrics are sampled.

Doctor

From the menu bar: Help → Run Doctor…. Mole gathers a short diagnostic report covering your Mac model, macOS version, permissions, recent operations, and environment. Click Copy Report to paste it into a chat, or Open GitHub Issue to land in a bug form with the report pre-filled.

Doctor detects five conditions: missing Full Disk Access, elevated memory pressure, disk usage above 90%, unwritable operations log, and recent operation failures. Each condition links to a help article with resolution steps. See the Help page for details on each.

Settings

Settings has three tabs. General: interface Language (applies after a relaunch), Launch at Login, Hide Dock Icon, License activation and device management, and a Full Disk Access shortcut. Maintenance: Cache Removal mode (Permanent deletion, the default for caches, or Trash routing), Protected Items whitelist, and the Optimize Dock Refresh toggle. Menu Bar: enable the Menu Bar Monitor, pick a runner character (Mole / Cat / Rabbit / Squirrel) or switch to live metrics, choose visible metrics for both runner lines, configure fan behavior where supported, record custom keyboard shortcuts for Menu Bar Toggle / Keep Screen On / Clean Screen, toggle Clean Screen Input Lock (Accessibility), and turn Privacy Signal and Keep Screen On notifications on or off. License activation is also reachable any time with Cmd + Shift + L.

CLI

Installation

Via Homebrew: brew install mole. Via script: curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash. Run mo for the interactive menu, or any subcommand directly.

Shared commands (also in the Mac app)

mo clean

Deep cleanup across the same ten categories as the Mac app. Supports --dry-run to preview without deleting, --debug for detailed logs, and --whitelist to manage protected caches. Skips caches of running apps automatically.

mo uninstall

Interactive app selection with remnant detection. Shows app size, bundle ID, and last-used date. Finds the same fifteen-plus leftover categories as the Mac app. Supports --dry-run.

mo optimize

Runs CLI maintenance tasks with admin prompts when needed. Its exact task set can differ from the Mac app's default Optimize list. Use --whitelist to exclude specific tasks from future runs.

mo analyze

Interactive treemap in the terminal. Navigate with arrow keys or Vim bindings (h/j/k/l). Trash files directly from the map. Supports --json output and custom paths like mo analyze /Volumes for external drives.

mo status

Live system dashboard: CPU, GPU, memory, disk I/O, network, battery, thermals, uptime, health score, and top processes with sixty-second sparklines. Supports --json for piping to other tools.

CLI-only commands

mo purge

Finds old build artifacts across project directories: node_modules, target, .build, build, dist, venv. Scans configurable paths (default: ~/Projects, ~/GitHub, ~/dev). Projects younger than 7 days are marked "Recent" and unselected by default. Supports --dry-run and --paths to configure scan directories.

mo installer

Discovers .dmg, .pkg, and .zip installer files in Downloads, Desktop, Homebrew cache, iCloud, and Mail attachments. Labels each file by source location. Supports --dry-run.

mo touchid

Enables Touch ID for sudo commands. Run mo touchid enable to configure, mo touchid disable to revert. Supports --dry-run.

Utility commands

mo completion

Sets up shell tab completion for Bash and Zsh. Auto-detects your shell and updates the appropriate config file.

mo update

Self-update to the latest stable release. Use --nightly for the latest unreleased build from main (script installs only). Use --force to reinstall the current version.

mo remove

Uninstalls Mole CLI from your system, including config files and shell integration. Supports --dry-run.

Safety

Both the CLI and Mac app share the same safety principles:

Path protection. A built-in deny list covers system-critical directories, your home folder's essential structure, and anything outside known cache locations. Symlinks are resolved and validated before any operation.

Process awareness. Caches belonging to running apps are skipped during cleanup. Browser caches are not touched while the browser is open.

License gate. In the Mac app, each destructive tool (Clean, Uninstall, Optimize, Analyze trash) works twice for free. After that, an active license is required. Scanning is always free.

Whitelist. Both the CLI (~/.config/mole/whitelist) and Mac app let you protect specific caches or optimization tasks from future runs.

Operations log. Every deletion is recorded at ~/Library/Logs/mole/operations.log. The Mac app's Doctor overlay checks the health of this log and surfaces any recent failures.

Preview first. The CLI supports --dry-run on every destructive command. The Mac app shows the full file list and byte count before any action.

Troubleshooting

The Mac app includes a built-in Doctor that detects common issues. Open it from Help → Run Doctor… in the menu bar. For specific conditions, see the Help page.

For the CLI, add --debug to any command for detailed logs. Review the operations log at ~/Library/Logs/mole/operations.log for recent activity. If a command fails silently, check whether Full Disk Access is granted in System Settings.

To report issues, see the Report a problem section on the Help page.