macos-cleaner

Analyze macOS storage usage and generate confirmed cleanup plans via Mole and tmux.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/HuuBar/skill-routing-experiment --skill macos-cleaner-huubar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-cleaner
Source: https://github.com/HuuBar/skill-routing-experiment/tree/main/unified_skills/daymade/macos-cleaner
Command: npx skills add https://github.com/HuuBar/skill-routing-experiment --skill macos-cleaner-huubar

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

macOS devices can accumulate space-hogging caches, logs, and orphaned data, leading to slowdowns and warnings. This Skill analyzes storage usage and provides a safety-first, guided cleanup plan that you can execute with user confirmation.

Core Features & Use Cases

  • Interactive disk usage analysis using Mole and multi-layer directory exploration to identify space-consuming targets.
  • Safety-first cleanup workflow with per-item verification, dry-run previews, and explicit user confirmation before any deletion.
  • Development-environment cleanup guidance (Docker, Homebrew, npm, pip, etc.) and orphaned data discovery to reclaim space without compromising active projects.

Quick Start

Start a Mole analysis session in a tmux window, review the dry-run cleanup plan, then proceed only after you confirm with the user.

Frequently Asked Questions about macos-cleaner

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

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

You can safely reclaim macOS storage using a guided cleanup workflow that analyzes disk usage, provides interactive dry-run previews, and requires explicit confirmation before deleting any caches or orphaned data.

What is consuming my macOS disk space and how can I identify large caches?

To identify what is consuming your macOS disk space, this Skill runs an interactive disk usage analysis using Mole and multi-layer directory exploration to pinpoint space-consuming targets like caches, logs, and orphaned data.

How do I clean up development environment caches like Docker and Homebrew on macOS?

To clean up development environment caches on macOS like Docker, Homebrew, npm, and pip, this Skill provides specific cleanup guidance to help you reclaim space without compromising your active projects.

Can I preview what files will be deleted before running a macOS cleanup?

Yes, you can preview files before a macOS cleanup because this Skill implements a safety-first workflow with interactive dry-run previews that show exactly what will be deleted before any action is taken.

Does this macOS cleanup workflow require tmux and Mole to run?

Yes, the macOS cleanup workflow requires tmux and Mole to start an interactive analysis session where you can review the dry-run cleanup plan and confirm deletions safely.