Mole鼴

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 is sent there, so double-check the spelling before paying. Apple iCloud addresses (@icloud.com, @me.com, @mac.com) and privacy relay or forwarding addresses (such as @duck.com) often filter or silently drop these emails; a Gmail or Outlook inbox is the most reliable.
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.

The license email didn't arrive

It usually lands within seconds. If you don't see it, check your Junk or Spam folder and search the mailbox for Dodo. Apple iCloud addresses (@icloud.com, @me.com, @mac.com) and relay addresses sometimes block it outright. If nothing shows up after a few minutes, email hi@mole.fit with your Payment ID or purchase email and I will resend the key, or send it to a different inbox.

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. 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.

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, including Mole, Ahu, RunCat, Shelly, Ember, Kong, Russet, Flex, Pixel, or a static silhouette.
• 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 Max 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 wiping the display and keyboard, especially with input lock enabled.

Optimize cadence

Optimize starts with a visible fix pass for self-healing services such as Dock, input-method switching, iCloud Drive sync, AirDrop, Spotlight, and Notification Center, then runs deeper maintenance. It automatically skips related tasks when VPN, Bluetooth keyboard or mouse, Bluetooth audio, external audio, or an external display is active, and skipped tasks surface a reason in the result list.

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.

Mole is frozen or keeps spinning

Do not force quit yet. While Mole is still stuck, open Terminal, paste this command, and press Return: curl -fsSL https://mole.fit/downloads/Mole-Diagnose.command | bash Running it from Terminal avoids the macOS “Apple could not verify” block. It writes a zip to the Desktop with process samples, recent Mole logs, and crash reports. You can review the folder before sharing it.

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 $19 one-time license, lifetime updates, and no subscription. 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.

Review-only by default: package caches with real rebuild cost (npm, yarn, pnpm, bun, CocoaPods, Gradle, Maven) and common project output (build, dist, target, .build, node_modules, venv). These folders can be large, but stay unchecked until you confirm. Auto-clean items arrive pre-checked; Settings can route cleanup through Trash.

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 ambiguous or weakly matched leftovers stay visible but unselected for review.

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.

Optimize starts with a visible fix pass for self-healing services such as Dock, input-method switching, iCloud Drive sync, AirDrop, Spotlight, and Notification Center. Deeper tasks include: rebuild Quick Look, font cache and Launch Services garbage collection; vacuum SQLite stores; clean saved application state, quarantine events and notification history; repair broken preferences, Launch Agents, shared file lists, and orphaned Spotlight rules; audit login items; and run periodic maintenance.

Safety gates skip tasks when conditions are unsafe: font cache rebuild is skipped when browsers are open, 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.

Analyze (Jupiter)

A treemap visualization of your entire disk. Drill down into any directory to see size at every level, with dense or similar items folded into summary blocks so the map stays readable.

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. The left list and real treemap blocks both keep item actions: open or reveal in Finder, and right-click for Move to Trash with confirmation. Summary blocks are overview-only. Block area in the treemap is proportional to byte size, so the biggest space hogs always sit visually largest.

Status (Sun)

A bento dashboard shows Health, CPU, GPU, Memory, Battery or Thermal, Disk, Network, and a hardware-dependent Fans or Thermal tile. Each metric carries a 60-second sparkline, and supported Macs expose fan controls for Auto, Cool, and Max 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 from Mole, Ahu, RunCat, Shelly, Ember, Kong, Russet, Flex, Pixel, or a static silhouette. 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 turns the screen into a plain color so you can wipe the display and keyboard with an optional Accessibility-gated input lock, and an Eject button appears there when an external drive or disk image can be unmounted. 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 choice 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, display, external volumes, network, security state, 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) and Protected Items whitelist. Battery Care keeps the built-in battery between 75% and 80% while Mole runs to slow wear, on supported Macs with one admin approval. Menu Bar: enable the Menu Bar Monitor, pick a runner 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.