@lechakrawarthy/vazr

Terminal UI for finding and eliminating disk bloat across your system.

Features

• Interactive checkbox UI — pick exactly what to clean
• Scans for temp/cache, old downloads, large media, dev artifacts (node_modules, dist, build...), and other large files
• Move files to an external drive or delete them
• Safe delete mode by default (sends deletes to OS Trash/Recycle Bin)
• --dry-run mode to safely preview before touching anything
• JSON config file support for repeatable runs
• Audit logging to a local log file
• Works on Windows, macOS, and Linux
• Live spinner during scan so you always know it's working
• Dashboard-style summary with category share and largest-file preview

Quick Start (no install)

npx @lechakrawarthy/vazr

Install globally

npm install -g @lechakrawarthy/vazr
vazr

Usage

Usage: vazr [options]

Options:
  -v, --version          Show version number
  -t, --target <path>    Destination path for moved files
                         If not provided, app prompts to choose a drive or continue delete-only
  --config <path>        Path to JSON config file
  --log-file <path>      Path to log file
  --force-delete         Permanently delete (bypass Trash/Recycle Bin)
  --dry-run              Preview changes without doing anything
  --min-media <mb>       Flag media files larger than this (default: 100)
  --min-large <mb>       Flag all files larger than this (default: 500)
  --old-days <days>      Flag downloads older than this many days (default: 60)
  -h, --help             Show help

Examples

# Standard interactive run
vazr

# Safe preview — nothing will be changed
vazr --dry-run

# Use a custom destination drive
vazr --target "D:\Archive"

# Persist settings in a config file
vazr --config "C:\Users\you\.vazr\config.json"

# Force permanent deletes (extra confirmation prompt appears)
vazr --force-delete

# More aggressive — flag media >= 50 MB, downloads >= 14 days old
vazr --min-media 50 --old-days 14

# Run with npx, dry-run first
npx @lechakrawarthy/vazr --dry-run

What it scans

| Category | Default Action | |---|---| | Temp & cache files (Windows/browser/npm) | Delete | | Downloads not touched in 60+ days | Move to drive | | Large media files (mp4, mkv, iso...) | Move to drive | | Dev artifact folders (node_modules, dist, build...) | Delete | | Other large files (catch-all) | Move to drive |

Moved files

Files set to "Move" are placed in your target drive preserving their original folder structure so you can always find them. They open normally from the external drive with no performance difference for media, archives, or project files.

Safety model

• By default, delete operations go to OS Trash/Recycle Bin.
• --force-delete enables permanent delete and requires typing DELETE to continue.
• When no destination is available, move-only categories automatically switch to safe alternatives.
• On startup, if destination is missing/unavailable, the app lets you pick an available drive or continue in delete-only mode.

Config file

You can set defaults in JSON:

{
  "target": "H:\\dev_hardware_moved",
  "minMediaMB": 100,
  "minLargeMB": 500,
  "oldDays": 60,
  "logFile": "C:\\Users\\you\\.vazr\\logs\\cleanup.log",
  "forceDelete": false
}

Default search paths for config:

• ~/.vazr/config.json
• ~/.vazr.json

You can override with --config or VAZR_CONFIG environment variable.

Audit log

By default logs are written to:

• ~/.vazr/logs/cleanup.log

Override with --log-file.

License

MIT