Disk Cleaner

A fast, interactive macOS CLI tool for disk cleanup. Scans directories by folder depth, shows the biggest space hogs first, and lets you decide what to trash with single keystrokes.

Philosophy

• Show the biggest items first
• Decide fast with single keystrokes
• Never delete — everything goes to ~/.Trash (always recoverable)
• Zero dependencies — Python 3 stdlib only

Features

• Scans any directory and sorts by size (largest first)
• Interactive mode: [t]rash, [s]kip, [q]uit per item
• Reads macOS Finder color tags (skip tagged items)
• Disk usage summary before and after
• Action log (disk_cleaner_log.csv) for every operation

Usage

python3 disk_cleaner.py ~/Downloads
python3 disk_cleaner.py ~/Library/Caches --depth 2

Requirements

• macOS (uses du, xattr, ~/.Trash)
• Python 3.6+
• No pip packages needed

License

MIT