A powerful command-line tool to organize and declutter your folders by automatically categorizing files into organized subdirectories based on their file types.

• 🚀 Smart File Organization: Automatically categorizes files by type (images, documents, videos, etc.)
• 📁 10+ File Categories: Supports images, documents, videos, audio, code, archives, and more
• 🔍 Preview Mode: See how files will be organized before making changes
• ⚡ Fast & Efficient: Built with Node.js for optimal performance
• 🎨 Beautiful CLI: Colorful and intuitive command-line interface
• 🛡️ Safe: Confirmation prompts and error handling to protect your files
• 🔧 Flexible: Multiple options and commands for different use cases

npm install -g declutter-cli

npm install declutter-cli

Simply run the command without arguments for an interactive experience:

declutter

declutter organize
# or
declutter o

declutter organize /path/to/folder
declutter o ~/Downloads

declutter preview
declutter preview /path/to/folder

declutter categories
# or
declutter c

• -f, --force: Skip confirmation prompt
• -q, --quiet: Run in quiet mode with minimal output
• --overwrite: Overwrite existing files in destination folders

# Organize without confirmation
declutter organize --force

# Organize quietly
declutter organize --quiet

# Organize with overwrite
declutter organize --overwrite

# Combine options
declutter organize ~/Downloads --force --quiet

The tool automatically organizes files into the following categories:

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

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

You can also use declutter-cli programmatically in your Node.js projects:

const { execSync } = require('child_process');

// Organize a folder
execSync('declutter organize /path/to/folder --force', { stdio: 'inherit' });

• Node.js 14.0.0 or higher
• npm or yarn

We welcome contributions! Please feel free to submit a Pull Request.

1. Clone the repository

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

2. Install dependencies

npm install

3. Link for local development

npm link

4. Test your changes

declutter --help

MIT License - see the LICENSE file for details.

If you encounter any issues or have suggestions, please open an issue on GitHub.

• Initial release
• Support for 10+ file categories
• Interactive and command-line modes
• Preview functionality
• Safe file operations with confirmations

Made with ❤️ for developers who love organized folders!