tidymymac

TidyMyMac is an open-source macOS storage cleanup utility aimed at developers. It scans, reviews and reclaims disk space from the terminal, with transparency and safety as stated design goals: inspect first, review before deleting, dry-run by default, and stay terminal-native. Features listed in the README include an interactive TUI for browsing and selecting what to clean, per-item selection in the review screen (deselect a single download, Docker image/container/volume, iOS backup or Time Machine snapshot for that run), a slash filter and select/deselect-all, dry-run by default, protected paths that no cleaner can touch regardless of flags, modular cleaners, named profiles bundling categories and project directories, progress reporting and reclaimed-space summaries, JSON or CSV export of scan results, shell cleanup script generation, and targeting specific categories in any command. The README motivates the tool by noting that macOS accumulates storage in hard-to-inspect places such as caches, developer artifacts, logs and the vague System Data category. Cleaners cover: temporary files (/tmp, /var/tmp, user temp directories); application caches (~/Library/Caches); system logs (~/Library/Logs, /Library/Logs, /var/log); Homebrew cache; Docker artifacts (stopped containers, untagged images, orphaned volumes); iOS backups; old macOS update residues and installers; installer files (.dmg, .pkg) and large items in ~/Downloads; app orphans from uninstalled apps; Xcode DerivedData, archives and simulators; Go build and module caches; project artifacts such as node_modules, dist, target and .venv plus files over 500MB in profile project paths; local Time Machine snapshots; and Trash. Installation options documented are a curl install script (installing to /usr/local/bin, falling back to $HOME/.local/bin, with sudo prompting), a Homebrew tap, go install, and building from source with make build. The README states Go 1.26+ is required. Usage centers on commands: scan (interactive table by default, category selection, profile scanning, JSON/CSV/table output, detailed output, --print-all, --save, --generate-script, --quiet); clean (dry-run default, --execute to delete, category or profile selection, --include-large-files, --from-file, JSON output, --prompt-sudo); profile (create, add-category, add-path, list, remove-path, delete); protect/unprotect and list protected; plus version, explain, list categories and history. Safety notes: dry-run by default, deletion only with --execute, protected paths as a hard block not overridable by CLI flags, built-in protection for AI model stores (~/.ollama/models and ~/.cache/huggingface) even without a config file, no silent operations, and non-fatal errors. Configuration lives in an optional ~/.tidymymac/config.yaml covering protected paths, categories disabled by default and profiles. Troubleshooting documentation notes that a terminal missing Full Disk Access on macOS can make Trash and some categories report 0 B. The project is MIT licensed.