mole-mac-cleaner

What This Skill Does

The Mole Mac Cleaner skill acts as an intelligent interface for the Mole (mo) CLI, a robust and all-in-one maintenance toolkit for macOS. This skill enables OpenClaw AI to perform deep system cleaning, smart application uninstallation, and disk space management directly on your machine. By leveraging the Mole binary, the agent can navigate complex file structures to identify and remove stale caches, browser clutter, developer artifacts like node_modules, and remnant files left behind by uninstalled applications. It effectively turns your AI agent into a system administrator, allowing you to optimize performance, regain storage space, and maintain system health without manually digging through hidden library folders or complex CLI commands.

Installation

To integrate this capability into your OpenClaw agent, ensure you have the Mole binary installed on your host system first via brew install mole. Once the prerequisite is met, install the skill using the following command in your terminal:

clawhub install openclaw/skills/skills/adisinghstudent/mole-mac-cleaner

Ensure that your agent has the necessary permissions to execute terminal commands on your local environment for the skill to function correctly.

Use Cases

This skill is ideal for power users and developers who experience system bloat or storage shortages. Common scenarios include:

1. Reclaiming disk space before a large project by purging project artifacts.
2. Deep-cleaning developer caches like Xcode or npm folders that are no longer in use.
3. Performing a clean sweep of system and browser caches to improve macOS responsiveness.
4. Safely removing unused applications along with their hidden configuration and log files.

Example Prompts

1. "OpenClaw, please run a safe preview of a deep clean to see how much space I can reclaim on my disk."
2. "Can you use Mole to find and remove the hidden remnants of all apps I have already uninstalled?"
3. "I need more space for my current project; please purge all unnecessary build artifacts like node_modules in my workspace."

Tips & Limitations

Always prioritize safety by utilizing the --dry-run flag before executing any destructive operations. While Mole is powerful, it is a system-level tool; always review the proposed changes. For critical system files you wish to keep, utilize the whitelist configuration found in ~/.config/mole/. Note that this skill requires direct terminal access, and users should ensure their system backups (like Time Machine) are up to date before running large-scale optimization tasks.