v1.0.0 — Initial Release

mac-storage-cleaner v1.0.0

A fast, safe macOS CLI tool to reclaim disk space.

Features

• clean — removes browser caches, app caches, logs, conda, pip, uv, npm caches
• scan — finds large stale files with color-coded age indicators
• find-large — identifies unused large files in Downloads, Documents, and Applications with interactive deletion
• clean-docker — prunes unused Docker data
• history — shows past cleaning runs
• schedule / unschedule — monthly automated scans with macOS notifications

Install

uv tool install mac-storage-cleaner