cleanMyMacSkill

Read-only storage analyzer for macOS, Windows, and Linux. Produces an interactive, Apple-style web-based dashboard with safe one-click cleanup integrations.

Core Directives

• Read-Only Scanner. The scanning phase only uses safe operations (e.g., df, du, stat, ls). Direct modifications or deletions are strictly prohibited during scanning.
• Interactive Deletions. In server mode, users can click "Move to Trash" or "Hard Delete" on the web page. The backend validates paths against strict session tokens and home boundaries.
• Accurate Estimates. Explicitly mark any reclaimable space values as estimates.
• Retain Command Snippets. Keep absolute paths and terminal command snippets exactly as they are (do not translate paths).

Execution Pipeline

Step 1: Run Storage Scan

Execute the multi-threaded scan script to collect filesystem size metadata:

python3 scripts/scan.py > /tmp/storage_scan.json

The script detects the OS automatically and concurrently queries cache targets, user folders, and developer structures using standard ThreadPoolExecutor. Denied folders are marked as denied.