aris-mac-cleaner
v4.0.2
Published
Premium macOS maintenance with organized menu and deep clean - Clean caches, free space, analyze disk, and optimize performance
Maintainers
salvadorreisReadme
█████╗ ██████╗ ██╗███████╗
██╔══██╗██╔══██╗██║██╔════╝
███████║██████╔╝██║███████╗
██╔══██║██╔══██╗██║╚════██║
██║ ██║██║ ██║██║███████║
╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚══════╝
╔═══════════════════════════════════════╗
║ MAC CLEANER PREMIUM v4.0.0 ║
║ Complete macOS Maintenance Suite ║
╚═══════════════════════════════════════╝Aris Mac Cleaner Premium
The most complete macOS maintenance and optimization CLI tool. Clean caches, free up disk space, analyze storage, and keep your Mac running fast.
Created by Salvador Reis
Installation
Via npx (recommended)
npx aris-mac-cleanerGlobal Installation
npm install -g aris-mac-cleaner
aris-mac-cleanerVia curl
curl -fsSL https://raw.githubusercontent.com/salvadorr/aris-mac-cleaner/main/install.sh | bashPremium Features
v4.0.0 - Organized Menu Structure
The menu is now organized into 3 clear sections with 17 options:
CLEANING (Options 1-7)
| Option | Feature | Description | |--------|---------|-------------| | 1 | Quick Clean | Fast cleanup of common caches and temp files | | 2 | Deep Clean | Aggressive cleanup: all caches, dev tools, old downloads, logs, font caches | | 3 | Large Files | Finds files larger than 100MB | | 4 | Duplicate Files | Detects and removes duplicate files | | 5 | Uninstall Apps | Completely removes applications (including residues) | | 6 | Browser Cleaner | Chrome, Safari, Firefox (cache, history, cookies) | | 7 | Privacy Sweep | Remove tracking data, cookies, browsing history |
ANALYSIS (Options A-E)
| Option | Feature | Description | |--------|---------|-------------| | A | Disk Analyzer | Visual treemap of disk usage | | B | Heavy Processes | Identifies and terminates high-consumption processes | | C | Startup Apps | Manages applications that start with the system | | D | Memory Optimizer | Free up RAM and optimize memory usage | | E | Benchmark Mode | Test and compare system performance |
SETTINGS (Options S, H, R, X)
| Option | Feature | Description | |--------|---------|-------------| | S | Scheduler | Schedule automated cleanups (daily/weekly/monthly) | | H | Cleanup History | Visual graphs showing cleanup history over time | | R | Export Report | Export detailed reports in HTML/JSON format | | X | Settings | Configure preferences, backup, dry-run mode |
Deep Clean Details
The new Deep Clean feature (option 2 or --deep flag) performs aggressive cleanup:
- All app caches - Clears every application cache
- Xcode derived data - Removes build artifacts
- Dev caches - npm, yarn, pip, homebrew, CocoaPods, pnpm
- Downloads 30+ days - Removes all old downloads (not just DMG/ZIP)
- All logs - Clears all system and application logs
- Font caches - Rebuilds font cache database
Additional Premium Features
| Feature | Description | |---------|-------------| | Animated ASCII Logo | Beautiful animated startup logo with gradient colors | | Progress Bars | Real-time animated progress bars during operations | | Gradient Colors | Stunning gradient color themes throughout the UI | | Sound Notifications | Audio alerts when operations complete | | Auto-Update Checker | Automatically checks for new versions | | Backup Before Clean | Creates backup before deleting files | | Dry-Run Mode | Preview what would be cleaned without executing | | Secure Delete | Military-grade secure file deletion | | Smart Recommendations | AI-powered cleanup suggestions |
CLI Flags
# Basic Commands
aris-mac-cleaner # Launch interactive menu
aris-mac-cleaner --quick # Quick automatic cleanup
aris-mac-cleaner --deep # Deep cleanup (all caches, dev tools, logs)
aris-mac-cleaner --preview # Show what would be cleaned
aris-mac-cleaner --version # Show version
# Premium Commands
aris-mac-cleaner --dry-run # Simulate cleanup without deleting
aris-mac-cleaner --benchmark # Run performance benchmark
aris-mac-cleaner --export # Export HTML cleanup report
aris-mac-cleaner --export=json # Export JSON cleanup report
aris-mac-cleaner --schedule # Configure scheduled cleanups
aris-mac-cleaner --backup # Create backup before cleaning
aris-mac-cleaner --secure # Use secure delete (slower)
aris-mac-cleaner --analyze # Launch disk analyzer
aris-mac-cleaner --privacy # Run privacy sweep
aris-mac-cleaner --optimize-memory # Optimize RAM usage
aris-mac-cleaner --no-sound # Disable sound notifications
aris-mac-cleaner --no-color # Disable colors (for CI/CD)Screenshots
Main Menu
╔══════════════════════════════════════════════════════════════════════╗
║ ARIS MAC CLEANER PREMIUM v4.0.0 ║
╠══════════════════════════════════════════════════════════════════════╣
║ Disk: 94Gi free │ RAM: 60% │ Health Score: 100/100 ║
╚══════════════════════════════════════════════════════════════════════╝
▶ CLEANING
[1] Quick Clean [5] Uninstall Apps
[2] Deep Clean [6] Browser Cleaner
[3] Large Files [7] Privacy Sweep
[4] Duplicate Files
▶ ANALYSIS
[A] Disk Analyzer [D] Memory Optimizer
[B] Heavy Processes [E] Benchmark Mode
[C] Startup Apps
▶ SETTINGS
[S] Scheduler [R] Export Report
[H] Cleanup History [X] Settings
[0] Exit
Select an option: _Progress Bar Animation
╔══════════════════════════════════════════════════════════════════════╗
║ CLEANING IN PROGRESS ║
╚══════════════════════════════════════════════════════════════════════╝
System Caches ████████████████████████████████████████ 100% 2.3 GB
App Caches ██████████████████████░░░░░░░░░░░░░░░░░░ 55% 1.1 GB
Temp Files ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0% ---
Old Logs ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0% ---
Total freed: 3.4 GB │ Time elapsed: 00:45Disk Analyzer Treemap
╔══════════════════════════════════════════════════════════════════════╗
║ DISK ANALYZER - Visual Treemap ║
╚══════════════════════════════════════════════════════════════════════╝
/Users/salvadorreis (256 GB used)
┌─────────────────────────────────────────────────────────────────┐
│ Library (45 GB) │ Documents (38 GB) │ Downloads │
│ ██████████████████████ │ ████████████████ │ (25 GB) │
│ ├─ Caches (12 GB) │ ├─ Projects (20 GB) │ ████████████ │
│ ├─ App Support (18 GB) │ ├─ PDFs (8 GB) │ │
│ └─ Logs (3 GB) │ └─ Other (10 GB) │ │
├─────────────────────────┴───────────────────────────────────────┤
│ Applications (65 GB) │ Other (83 GB) │
│ ████████████████████████████████ │ ██████████████████████████ │
└─────────────────────────────────────────────────────────────────┘Cleanup History Graph
╔══════════════════════════════════════════════════════════════════════╗
║ CLEANUP HISTORY - Last 30 Days ║
╚══════════════════════════════════════════════════════════════════════╝
Space Freed (GB)
8 ┤
7 ┤ ╭─╮
6 ┤ ╭─╮ │ │
5 ┤ ╭─╮ │ │ ╭─╮ │ │
4 ┤ ╭─╮ │ │ ╭─╮ │ │ │ │ ╭─╮ │ │
3 ┼───│ │───│ │──│ │──│ │───│ │─│ │─│ │
2 ┤ │ │ │ │ │ │ │ │ │ │ │ │ │ │
1 ┤ │ │ │ │ │ │ │ │ │ │ │ │ │ │
0 ┴───┴─┴───┴─┴──┴─┴──┴─┴───┴─┴─┴─┴─┴─┴──────
Jan 1 Jan 8 Jan 15 Jan 22 Jan 29
Total freed this month: 42.5 GB │ Cleanups: 12Requirements
- macOS (Darwin)
- Node.js >= 14
Changelog
v4.0.0
- Reorganized menu into 3 sections: CLEANING, ANALYSIS, SETTINGS
- Added Deep Clean - aggressive cleanup with all caches, dev tools, old downloads, logs, font caches
- Added --deep flag for CLI automation
- Improved menu layout with 17 organized options
- Quick vs Deep clean modes with logging
v3.5.0 (Premium)
- Added animated ASCII logo with gradient colors
- Added progress bars with smooth animations
- Added sound notifications
- Added auto-update checker
- Added scheduler for automated cleanups
- Added backup before cleaning
- Added dry-run mode
- Added cleanup history with visual graphs
- Added secure delete option
- Added disk analyzer with visual treemap
- Added smart recommendations
- Added HTML/JSON report export
- Added benchmark mode
- Added privacy sweep
- Added memory optimizer
v3.0.0
- Initial public release
- Quick clean, large files, duplicates
- App uninstaller, startup apps
- Browser cleaner, heavy processes
- Statistics and settings
- Bilingual support (PT/EN)
License
MIT © Salvador Reis