rmempty

A simple Node.js CLI tool to remove empty directories with recursive support.

Installation

No installation required! Use directly with npx:

npx rmempty [options] <directory>

Usage

Basic Usage

Remove empty directories in the current directory:

npx rmempty .

Remove empty directories in a specific path:

npx rmempty ./path/to/directory

Recursive Mode

Remove empty directories recursively (including nested empty directories):

npx rmempty -r ./path/to/directory
# or
npx rmempty --recursive ./path/to/directory

Verbose Output

Show detailed output of what's being removed:

npx rmempty -v ./path/to/directory
# or
npx rmempty --verbose ./path/to/directory

Combine Options

Use recursive mode with verbose output:

npx rmempty -r -v ./path/to/directory
# or
npx rmempty --recursive --verbose ./path/to/directory

Help

Show help information:

npx rmempty -h
# or
npx rmempty --help

Examples

# Remove empty directories in current folder
npx rmempty .

# Remove empty directories recursively in a project
npx rmempty -r ./my-project

# Clean up build artifacts with verbose output
npx rmempty -r -v ./dist

# Remove empty directories in a specific path
npx rmempty /path/to/cleanup

How It Works

• Non-recursive mode: Only removes empty directories at the specified level
• Recursive mode: Removes empty directories and their parent directories if they become empty after removal
• Safe operation: Only removes directories that are completely empty (no files or subdirectories)
• Error handling: Provides clear error messages for invalid paths or permissions issues

Requirements

• Node.js 12.0.0 or higher