mac-cleaner

What This Skill Does

The mac-cleaner skill is a robust maintenance utility designed for OpenClaw to analyze and safely reclaim disk space on macOS. It targets non-essential files that typically clutter user storage over time. The skill operates in two primary modes: an analysis mode that identifies space-heavy items without modifying them, and a cleaning mode that performs safe deletions. It specifically targets high-volume storage offenders such as user cache files, outdated Xcode derived data, inactive iOS simulator devices, browser caches, and logs older than seven days. By automating the cleanup of these temporary artifacts, the skill helps restore performance and capacity to your Mac without requiring deep technical knowledge.

Installation

To integrate this utility into your OpenClaw environment, use the following command in your terminal: clawhub install openclaw/skills/skills/apprithm/mac-cleaner Once installed, ensure your environment has the necessary permissions to access the standard user Library directories to allow the script to perform its cleanup duties effectively.

Use Cases

This skill is ideal for users struggling with the 'System Data' storage warning, those noticing rapid disk space depletion, or developers whose build artifacts have bloated their primary drive. It acts as a safety layer for everyday maintenance, ensuring that only expendable data is purged while critical system folders and active user backups remain untouched. It is especially useful for managing shared developer environments where Xcode and Simulator data can quickly reach multi-gigabyte sizes.

Example Prompts

1. 'My Mac is complaining about low disk space, specifically in System Data. Can you check what's taking up room?'
2. 'I need to free up at least 20GB on my laptop. Please analyze my current disk usage and clean the safe temporary files.'
3. 'Why is my disk nearly full? Can you run a cleanup and remove my old browser caches and Xcode derived data?'

Tips & Limitations

While the skill is designed to be safe, always exercise caution with items marked as 'Review'. Never attempt to manually clear /System folders or /private/var/db as these are vital to system integrity. If you are low on disk space, prioritize emptying the Trash and clearing Xcode build files first. If you use Parallels or large iOS backups, verify their importance before utilizing the manual cleanup instructions provided in the documentation. For best results, run the 'analyze' command before committing to any 'clean' operation to preview potential space gains.