How lechakrawarthy/vazr works
vazr is a cross-platform CLI for finding and safely cleaning disk bloat. The main workflow is: parse CLI options and configuration, scan files into cleanup categories, review and select actions in the TUI (or export results), then execute deletions or moves and record operations. Profiles provide reusable scan settings; update notices are an optional side path. The graph follows the documented capabilities and sampled call sites; unsampled internals are represented only where the README and tree support them.
Main entry points: index.js Cleanup orchestrator · vazr.js Command entry · scanner.js Category scanning · review.js Interactive review
Components 21
CLI & Configuration
- Command entry
bin/vazr.js - Config loading
src/config.js - Option validation
src/validators.js
Discovery & Review
- Cleanup orchestrator
src/index.js - Category scanning
src/scanner.js - Platform paths
src/platform.js - Interactive review
src/tui/review.js - Terminal screens
src/tui/screen.js - Keyboard input
src/tui/input.js
Cleanup & Reporting
- File operations
src/executor.js - Audit logging
src/logger.js - Audit log
- Result export
src/exporter.js - Update check
src/update-check.js
Profiles
- Profile commands
bin/vazr.js - Profile handling
src/profiles.js - Profile files
Other components
- CLI user
- Local filesystem
- OS Trash
- npm registry
Connections 22
- CLI user → Command entry: runs commands
- Command entry → Config loading: loads settings
- Command entry → Option validation: validates options
- Command entry → Profile handling: manages profiles
- Profile commands → Profile handling: runs commands
- Profile handling → Profile files: reads/writes
- Command entry → Cleanup orchestrator: starts cleanup
- Cleanup orchestrator → Category scanning: scans categories
- Category scanning → Platform paths: gets scan roots
- Category scanning → Local filesystem: reads paths
- Cleanup orchestrator → Interactive review: requests review
- Cleanup orchestrator → Terminal screens: renders progress
- Interactive review → Terminal screens: renders review
- Interactive review → Keyboard input: reads keys
- Cleanup orchestrator → File operations: executes selections
- File operations → Local filesystem: moves/deletes
- File operations → OS Trash: trashes items
- Cleanup orchestrator → Audit logging: records operations
- Audit logging → Audit log: writes entries
- Cleanup orchestrator → Result export: exports results
- Cleanup orchestrator → Update check: checks version
- Update check → npm registry: queries registry