mac-cleaner-cli-disk-cleanup

Free disk space on macOS by cleaning caches, logs, and development artifacts via an interactive CLI.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/devtools-skills --skill mac-cleaner-cli-disk-cleanup-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mac-cleaner-cli-disk-cleanup
Source: https://github.com/reason-machines/devtools-skills/tree/main/skills/mac-cleaner-cli-disk-cleanup
Command: npx skills add https://github.com/reason-machines/devtools-skills --skill mac-cleaner-cli-disk-cleanup-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? macOS systems accumulate caches, logs, Homebrew downloads, Xcode DerivedData, orphaned node_modules, and other junk that silently consume disk space, and manually locating and removing these files is tedious and error-prone. ## Core Features & Use Cases - Interactive Cleanup: Scan the system and select categories to clean via checkbox UI, with a drill-down file explorer for granular control over individual folders. - Tiered Safety Model: Safe, moderate, and risky categories, where risky items like old downloads, iOS backups, and large files require the --risky flag. - App Uninstaller & Maintenance: Completely remove applications with their preferences and support files, flush DNS cache, and free purgeable space. - Use Case: A developer running low on disk space runs the cleaner, selects Development Cache and node_modules categories, drills into specific Xcode DerivedData folders, and reclaims tens of gigabytes without touching personal files. ## Quick Start Run the mac cleaner CLI in interactive mode to scan my Mac and clean safe categories like trash, browser cache, and development caches.

Frequently Asked Questions about mac-cleaner-cli-disk-cleanup

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

FAQPage Schema
How do I free up disk space on macOS from the command line?▼

Run npx mac-cleaner-cli to launch an interactive scan of caches, logs, temporary files, and development artifacts. Select categories with checkboxes, drill into folders with the arrow keys, and confirm to delete the selected items.

How to clean Xcode DerivedData and npm cache on Mac?▼

Run npx mac-cleaner-cli and select the Development Cache category, which covers npm, yarn, pip, Xcode DerivedData, and CocoaPods. You can also select the node-modules category to remove orphaned dependency folders from old projects.

Does mac-cleaner-cli delete personal files like downloads or backups?▼

Risky categories such as downloads older than 30 days, iOS backups, mail attachments, duplicates, and large files are hidden by default. They only appear when you pass the --risky flag, and every item still requires manual selection before deletion.

Can I completely uninstall Mac apps including preferences and caches?▼

Yes, run npx mac-cleaner-cli uninstall and pick an app from the list. The tool removes the .app bundle along with its preferences, caches, and application support files, which dragging to Trash leaves behind.

Why do I get permission denied errors when cleaning system files?▼

The tool runs as the current user, so some system locations are not writable. Most categories work without elevation, but the DNS flush maintenance task requires running with sudo.

Does mac-cleaner-cli work on Windows or Linux?▼

No, it is designed specifically for macOS and targets macOS-specific paths like ~/Library/Caches and Xcode DerivedData. The documentation points Windows users to a separate windows-cleaner-cli project.