macos-cleaner
Audited by Runlayer on Feb 23, 2026
Malicious tool definition detected
Tool: .security-scan-passed Description: Security scan passed
Malicious tool definition detected
Tool: SKILL.md [1/5] Description: --- name: macos-cleaner description: Analyze and reclaim macOS disk space through intelligent cleanup recommendations. This skill should be used when users report disk space issues, need to clean up their Mac, or want to understand what's consuming storage.
Tool: SKILL.md [2/5] Description: `~/Library/Containers/*` - Sandboxed app data **Analysis approach:** 1. List installed applications in `/Applications` 2.
Tool: SKILL.md [3/5] Description: to parent tmux send-keys -t mole Left sleep 2 # Navigate to different directory tmux send-keys -t mole Down Down Down Down Enter # Go to .npm sleep 5 && tmux capture-pane -t mole -p ``` **Step 5: Deep dive into Library** ```bash # Back to Home, then into Library tmux send-keys -t mole Left tmux send-keys -t mole Up Up Up Up Up Up Enter # Go to Library sleep 10 && tmux capture-pane -t mole -p # Example output: # 1.
Tool: SKILL.md [4/5] Description: | |------|------|----------------|------------|-------------------| | Trash | 643 MB | 🟢 | Files you deleted | None | | npm _npx | 2.1 GB | 🟢 | Temp npx packages | Minor redownload | | npm _cacache | 5 GB | 🟡 | Package cache | 30min-2hr redownload | | DerivedData | 10 GB | 🟡 | Xcode build cache | 10-30min rebuild | | Docker volumes | 11 GB | 🔴 | Project databases | **DATA LOSS** | ### Recommendation Only items marked 🟢 are recommended for cleanup.
Tool: SKILL.md [5/5] Description: ``` **Report format:** ``` ✅ Cleanup Complete! Before: 450 GB used (90%) After: 385 GB used (77%) ━━━━━━━━━━━━━━━━━━━━━━━━ Recovered: 65 GB Breakdown: - System caches: 45 GB - Downloads: 12 GB - Homebrew cache: 5 GB - Application remnants: 3 GB ⚠️ Notes: - Some applications may take longer to launch on first run - Deleted items cannot be recovered unless you have Time Machine backup - Consider running this cleanup monthly 💡 Maintenance Tips: - Set up automatic H
Malicious tool definition detected
Tool: references/cleanup_targets.md [1/2] Description: # macOS Cleanup Targets Reference Detailed explanations of cleanup targets, their safety levels, and impact.
Tool: references/cleanup_targets.md [2/2] Description: Files - `/System` - `/Library/Apple` (unless you know what you're doing) - `/private/etc` ### Security & Credentials - `~/.ssh` (SSH keys) - `~/Library/Keychains` (passwords, certificates) - Any files containing credentials ### Active Databases - `*.db`, `*.sqlite` files for running applications - Docker volumes in active use ## Safety Checklist Before deleting ANY directory: 1.
Malicious tool definition detected
Tool: references/mole_integration.md [1/2] Description: # Mole Integration Guide How to integrate [Mole](https://github.com/tw93/Mole) with the macOS Cleaner skill.
Tool: references/mole_integration.md [2/2] Description: - AI project fails because models need redownload **Items that should usually be KEPT:** | Item | Why Keep It | |------|-------------| | Xcode DerivedData | Saves 10-30 min per rebuild | | npm _cacache | Avoids re-downloading all packages | | ~/.cache/uv | Python package cache | | Playwright browsers | Avoids 2GB+ redownload | | iOS DeviceSupport | Needed for device debugging | | Docker stopped containers | May restart anytime | **Items tha
Malicious tool definition detected
Tool: references/safety_rules.md [1/2] Description: # Safety Rules for macOS Cleanup Critical safety guidelines to prevent data loss and system damage.
Tool: references/safety_rules.md [2/2] Description: Final confirmation if not confirm_delete(path, size, description): return (False, "User cancelled") # Execute deletion try: if os.path.isfile(path): os.unlink(path) else: shutil.rmtree(path) return (True, f"Deleted successfully ({format_size(size)} freed)") except Exception as e: return (False, f"Deletion failed: {str(e)}") ``` ## Error Handling ### Permission Denied ```python except PermissionError: print(f"❌ Permission denied: {path}") print(
Malicious tool definition detected
Tool: scripts/analyze_caches.py Description: #!/usr/bin/env python3 """ Analyze macOS cache directories and categorize them by size and safety.
Malicious tool definition detected
Tool: scripts/analyze_dev_env.py Description: #!/usr/bin/env python3 """ Analyze development environment and find cleanable resources.
Malicious tool definition detected
Tool: scripts/analyze_large_files.py Description: #!/usr/bin/env python3 """ Find large files on macOS and categorize them.
Malicious tool definition detected
Tool: scripts/cleanup_report.py Description: #!/usr/bin/env python3 """ Generate before/after cleanup reports.
Malicious tool definition detected
Tool: scripts/find_app_remnants.py Description: #!/usr/bin/env python3 """ Find orphaned application support files and preferences.
Malicious tool definition detected
Tool: scripts/safe_delete.py Description: #!/usr/bin/env python3 """ Interactive safe file/directory deletion with confirmation.