deletor

name	deletor
description	Use this skill when the user wants to clean up, delete, or manage files by filtering on extension, size, or age from the command line.

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