macos-cleaner

Analyze macOS disk usage and provide interactive cleaning recommendations.

1|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/evanfang0054/cc-system-creator-scripts --skill macos-cleaner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-cleaner
Source: https://github.com/evanfang0054/cc-system-creator-scripts/tree/main/skills/macos-cleaner
Command: npx skills add https://github.com/evanfang0054/cc-system-creator-scripts --skill macos-cleaner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill helps users safely reclaim disk space on macOS by analyzing storage usage and providing interactive, user-confirmed cleanup recommendations.

Core Features & Use Cases

  • Interactive analysis: Scans caches, logs, development environments, and large files to identify reclaimable space.
  • Safe-by-default cleanup guidance: Presents what will be deleted and its impact, requiring explicit user confirmation before any action.
  • Mole + tmux workflow support: Uses Mole analysis in a TTY session via tmux for reliable execution on Claude Code. Use Case: A developer running low on disk space can run the diagnostic, review recommended removals, and manually apply the safe deletions.

Quick Start

Use the macos-cleaner skill to start a tmux session and run Mole analysis on your home directory.

Frequently Asked Questions about macos-cleaner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely clean up disk space on macOS without deleting important files?

To safely clean up macOS disk space, you can use a guided workflow that scans caches, logs, and large files, then presents reclaimable items for explicit user confirmation before any deletion occurs. This prevents accidental loss of important data.

What is consuming my macOS storage space in development environments?

Development environments on macOS consume storage through accumulated caches, logs, and remnant files. Analyzing disk usage with a Python-based scanner identifies these large files and environment remnants, showing exactly what consumes your storage.

Can I analyze macOS disk usage interactively in a tmux session?

Yes, you can analyze macOS disk usage interactively in a tmux session. Running the analysis in a TTY session via tmux ensures reliable execution on Claude Code, using Mole to scan your home directory for reclaimable space.

Does safe macOS cleanup require manual confirmation before removing files?

Safe macOS cleanup requires explicit manual confirmation before removing any files. The workflow presents what will be deleted and its impact, ensuring a cautious, user-confirmed cleanup process that defaults to keeping data intact unless approved.

What is the best way to reclaim macOS storage from caches and large files?

The best way to reclaim macOS storage is running a diagnostic scan to identify caches, logs, and large files, reviewing the recommended removals and their impact, then manually applying the safe deletions to free up disk space.