Deletor

deletor Plugin

Manage and delete files efficiently with a scriptable CLI mode. Filter by extension, size, age, and preview before removing. Supports smart rules and progress tracking.

Commands

File Cleanup

• deletor files clean — Clean files in CLI mode with filters

Utility

• deletor self version — Print deletor version
• deletor _ _ — Passthrough to deletor CLI

Usage Examples

• "Clean old log files from /var/log"
• "Delete all zip files in Downloads larger than 100MB"
• "Remove files older than 30 days in temp directory"
• "Preview files matching *.tmp before deleting"
• "Clean up node_modules and vendor directories"

Installation

go install github.com/pashkov256/deletor@latest

Examples

# Preview files in Downloads (no deletion)
deletor files clean -d ~/Downloads

# Delete mp4 and zip files in Downloads
deletor files clean -d ~/Downloads -e mp4,zip -skip-confirm

# Delete files larger than 100MB
deletor files clean -d ~/Downloads --min-size 100mb -skip-confirm

# Delete files between 10KB and 1MB
deletor files clean -d ~/Downloads --min-size 10kb --max-size 1mb -skip-confirm

# Delete files older than 7 days
deletor files clean -d ~/temp --older 7day -skip-confirm

# Delete files newer than 1 hour
deletor files clean -d ~/uploads --newer 1hour -skip-confirm

# Include subdirectories
deletor files clean -d ~/Projects -e log -subdirs -skip-confirm

# Exclude specific directories
deletor files clean -d ~/Projects -e tmp --exclude node_modules,vendor -subdirs -skip-confirm

# Remove empty directories after deletion
deletor files clean -d ~/Downloads -e tmp -prune-empty -skip-confirm

# Use smart rules for safe deletion
deletor files clean -d ~/Downloads -rules -skip-confirm

# Show progress
deletor files clean -d ~/Downloads -e mp4 -progress -skip-confirm

Key Features

• Filter by file extension (comma-separated)
• Filter by minimum and maximum file size
• Filter by file age (older than or newer than)
• Include or exclude subdirectories
• Exclude specific directories or files
• Prune empty directories after deletion
• Smart rules for safer deletion
• Progress tracking for large operations
• Confirmation prompts by default (use -skip-confirm to bypass)

Safety Notes

• By default, deletor prompts for confirmation before deleting
• Use -skip-confirm only when you are certain about the targets
• Always preview with -rules before bulk deletion
• The -rules flag applies smart safety rules to prevent accidental deletions