🧹 neatcli: The Ultimate Directory Cleaner & Organizer

(A smart, lightning-fast CLI tool to organize and clean up your messy folders, built in Rust).

Are your Downloads, Documents, or Photos folders a total disaster? neatcli is here to save your sanity. With just a single command, you can automatically sort thousands of files, find hidden duplicates, and reclaim your hard drive space.

🛡️ Safe by Default

We know command-line tools can be scary. That's why neatcli is designed with your safety in mind:

• Preview First (Dry-run): By default, it only shows you what it will do. Nothing is actually moved or deleted until you explicitly add the --execute flag.
• Trash Support: You can choose to move files to the system Trash instead of permanently deleting them.
• Undo Mistakes: Accidentally moved something you shouldn't have? Just type neatcli undo and everything goes back to exactly how it was.

✨ Key Features

• 📂 Auto-Organize: Instantly sort files into neat folders by Type (Images, Videos, Archives, Code), Extension, or Date (YYYY/MM).
• 📸 Smart Metadata: Organize photos perfectly by Camera Model or Date Taken (reading EXIF data), and music by Artist / Album.
• 👯 Find Duplicates & Similar Images: Quickly detect duplicate files using blazing-fast xxHash3, or find visually similar photos to free up storage.
• 🗑️ Clean Old Junk: Remove or trash files that are older than a specific timeframe (e.g., older than 30 days).
• 🤖 Watch Mode: Leave it running in the background to automatically organize new files as soon as they drop into your folder.

🚀 Getting Started

Quick Examples:

```bash

1. Preview organizing your Downloads folder by file type

./neatcli organize ~/Downloads --by-type

2. Looks good? Execute it!

./neatcli organize ~/Downloads --by-type --execute

3. Find and trash duplicate files safely

./neatcli duplicates ~/Downloads --delete --trash --execute

4. Made a mistake? Roll it back!

./neatcli undo