mac-cleanup

Reclaim macOS disk space by removing caches and temporary files.

1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/snqb/my-skills --skill mac-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mac-cleanup
Source: https://github.com/snqb/my-skills/tree/main/mac-cleanup
Command: npx skills add https://github.com/snqb/my-skills --skill mac-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool helps macOS users reclaim disk space by safely removing unnecessary caches, logs, and temporary data while minimizing risk to personal files.

Core Features & Use Cases

  • Safe, preview-first cleanup before actual deletion.
  • Comprehensive target categories (system caches, logs, developer caches, app caches).
  • Optional Docker cleanup integrated.

Quick Start

Preview what would be cleaned by running mac-cleanup -clean -dry-run.

Frequently Asked Questions about mac-cleanup

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 personal files?

You can free up disk space on macOS by removing safe-to-delete caches, logs, and temporary files. This skill targets system and developer caches while enforcing safe operation through dry-run previews and explicit target configuration.

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

Yes, you can preview cleanup actions by running the command with a dry-run flag. This allows you to manually verify the identified system caches, logs, and temporary data before any actual deletion occurs on your macOS system.

Does the macOS disk cleanup script include Docker container hygiene?

Yes, macOS disk cleanup includes an inbuilt Docker cleanup workflow for container hygiene. This targets select application data and developer caches to reclaim disk space while maintaining your Docker environment.

What developer caches and temporary files can I clear to reclaim disk space on macOS?

You can clear comprehensive target categories including system caches, logs, developer caches, and app caches. The cleanup process identifies these temporary files and removes them safely to reclaim disk space on your macOS system.

What's the best way to safely clean up system caches on macOS?

The best way to safely clean up system caches is using a preview-first approach with explicit target configuration. This minimizes risk to personal files by identifying safe-to-delete temporary data and allowing manual verification before action.

Are there limitations or risks when using scripts to clean up macOS disk space?

While cleanup scripts minimize risk to personal files by targeting only safe-to-delete caches and logs, you should always use the dry-run preview feature first. This ensures manual verification of temporary files before actual deletion occurs.