🚀 Introducing Declutter CLI: A Smart Way to Organize Your Folders

Do you ever feel overwhelmed by a messy Downloads folder? Or wish you could instantly organize your scattered files into neat categories? I felt the same, so I built Declutter CLI, a powerful and easy-to-use command-line tool to automatically organize and declutter your folders.

📷 Preview

🔗 Links

• NPM: www.npmjs.com/package/declutter-cli
• GitHub: www.github.com/nil-official/Declutter-CLI

🎯 What is Declutter CLI?

Declutter CLI is a Node.js-powered tool that categorizes your files into organized subdirectories based on file type. Whether it’s images, documents, videos, or code files - Declutter CLI will help you keep your directories clean with minimal effort.

✨ Features

• Smart File Organization: Automatically sorts files by type (images, documents, videos, code, and more)
• 10+ File Categories: Supports a wide range of file types
• Preview Mode: See how files will be organized before making changes
• Fast & Efficient: Optimized performance with Node.js
• Beautiful CLI: Colorful, intuitive interface
• Safe Operations: Confirmation prompts and robust error handling
• Flexible Commands: Works for various use cases with different options

📦 Installation

Recommended (Global Installation)
npm install -g declutter-cli
or
Local Installation
npm install declutter-cli

⚡ Quick Usage

Interactive mode
declutter
Organize current directory
declutter organize
Organize a specific directory
declutter organize ~/Downloads
Preview changes (no files moved)
declutter preview

📂 Example

Before:

Downloads/
├── photo.jpg
├── document.pdf
├── song.mp3
├── video.mp4
├── archive.zip
├── script.js
└── app.exe

After:

Downloads/
├── Images/
│ └── photo.jpg
├── Documents/
│ └── document.pdf
├── Audio/
│ └── song.mp3
├── Videos/
│ └── video.mp4
├── Archives/
│ └── archive.zip
├── Code/
│ └── script.js
├── Applications/
│ └── app.exe

🛠️ Contribute

Declutter CLI is open source and I welcome contributions. Feel free to fork the repo, open pull requests, or suggest ideas via issues.

git clone https://github.com/nil-official/Declutter-CLI.git
cd Declutter-CLI
npm install
npm link

🌱 Final Thoughts

Declutter CLI is built for developers (and anyone else!) who want their directories organized effortlessly. Give it a try, and let me know what you think!

Made with ❤️ for devs who love clean folders.