Tired of a Messy Downloads Folder? Try Declutter CLI!



This content originally appeared on DEV Community and was authored by Niladri Chakraborty

🚀 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

Declutter-CLI Demo

🔗 Links

🎯 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.


This content originally appeared on DEV Community and was authored by Niladri Chakraborty