Auto-organize – Clean up messy folders with a single npx command

I created this because my Downloads folder was a graveyard of mixed images, PDFs, and audio files. I wanted a way to fix it without doing manual tasks.

How it works:

- It’s a CLI tool built with Node.js. You just navigate to any cluttered directory and run 'npx auto-organize'. It analyzes file extensions and groups them into "thematic" folders (e.g., .png and .jpg go into "Images").

Key Features:

- Zero Permanent Install: You can use 'npx auto-organize' for one-time cleanups or 'npm install -g auto-organize' for frequent use.

- Safe Moving: It doesn’t delete or rename anything, just moves files. It also detects and prevents overwriting files with the same name.

- Flexible: It includes flags like --only to target specific formats or --exclude to skip certain files.

- Smart Folders: It reuses existing directories instead of creating duplicates.

Tech Stack:

- Plain JavaScript (Node.js) with only two UI dependencies: 'Chalk' for terminal colors and 'Ora' for the spinner animation.

Future Idea:

- I’m thinking about allowing users to define their own category mappings (e.g., specific extensions for specific folder names).

Feedback, suggestions or contributions for improvement are very welcome.

- Repo (Open Source): https://github.com/ChristianRincon/auto-organize

- npm package: https://www.npmjs.com/package/auto-organize