diff --git a/README.md b/README.md index 93bf2a3..6c3f7e0 100644 --- a/README.md +++ b/README.md @@ -68,40 +68,40 @@ git checkout windows Run: ```powershell -mole # Interactive menu -mole clean # Deep cleanup -mole uninstall # Remove apps + leftovers -mole optimize # Refresh caches & services -mole analyze # Visual disk explorer -mole status # Live system health dashboard -mole purge # Clean project build artifacts +mo # Interactive menu +mo clean # Deep cleanup +mo uninstall # Remove apps + leftovers +mo optimize # Refresh caches & services +mo analyze # Visual disk explorer +mo status # Live system health dashboard +mo purge # Clean project build artifacts -mole -ShowHelp # Show help -mole -Version # Show installed version +mo --help # Show help +mo --version # Show installed version -mole clean -DryRun # Preview the cleanup plan -mole clean -Whitelist # Manage protected caches -mole clean -DryRun -Debug # Detailed preview with risk levels +mo clean --dry-run # Preview the cleanup plan +mo clean --whitelist # Manage protected caches +mo clean --dry-run --debug # Detailed preview with risk levels -mole optimize -DryRun # Preview optimization actions -mole optimize -Debug # Run with detailed operation logs -mole purge -Paths # Configure project scan directories +mo optimize --dry-run # Preview optimization actions +mo optimize --debug # Run with detailed operation logs +mo purge --paths # Configure project scan directories ``` ## Tips -- **Safety**: Built with strict protections. Preview changes with `mole clean -DryRun`. +- **Safety**: Built with strict protections. Preview changes with `mo clean --dry-run`. - **Be Careful**: Although safe by design, file deletion is permanent. Please review operations carefully. -- **Debug Mode**: Use `-Debug` for detailed logs (e.g., `mole clean -Debug`). Combine with `-DryRun` for comprehensive preview including risk levels and file details. +- **Debug Mode**: Use `--debug` for detailed logs (e.g., `mo clean --debug`). Combine with `--dry-run` for comprehensive preview including risk levels and file details. - **Navigation**: Supports arrow keys for TUI navigation. -- **Configuration**: Use `mole clean -Whitelist` to manage protected paths, `mole purge -Paths` to configure scan directories. +- **Configuration**: Use `mo clean --whitelist` to manage protected paths, `mo purge --paths` to configure scan directories. ## Features in Detail ### Deep System Cleanup ```powershell -mole clean +mo clean ``` ``` @@ -122,7 +122,7 @@ Space freed: 56.1GB | Free space now: 180.3GB ### Smart App Uninstaller ```powershell -mole uninstall +mo uninstall ``` ``` @@ -148,7 +148,7 @@ Space freed: 4.8GB ### System Optimization ```powershell -mole optimize +mo optimize ``` ``` @@ -160,6 +160,7 @@ System: 12/32 GB RAM | 280/460 GB Disk (61%) | Uptime 6d ✓ Refresh Windows Search index ✓ Clear thumbnail cache ✓ Optimize startup programs + ✓ System repairs (Font/Icon/Store/Search) ==================================================================== System optimization completed @@ -169,7 +170,7 @@ System optimization completed ### Disk Space Analyzer ```powershell -mole analyze +mo analyze ``` ``` @@ -189,7 +190,7 @@ Analyze Disk C:\Users\YourName\Documents | Total: 156.8GB Real-time dashboard with system health score, hardware info, and performance metrics. ```powershell -mole status +mo status ``` ``` @@ -219,7 +220,7 @@ Health score based on CPU, memory, disk, temperature, and I/O load. Color-coded Clean old build artifacts (`node_modules`, `target`, `build`, `dist`, etc.) from your projects to free up disk space. ```powershell -mole purge +mo purge ``` ``` @@ -237,7 +238,7 @@ Select Categories to Clean - 18.5GB (8 selected) Use with caution: This will permanently delete selected artifacts. Review carefully before confirming. Recent projects — less than 7 days old — are marked and unselected by default. -Custom scan paths can be configured with `mole purge -Paths`. +Custom scan paths can be configured with `mo purge --paths`. ## Installation Options diff --git a/bin/clean.ps1 b/bin/clean.ps1 index 6220a5b..e3deaa8 100644 --- a/bin/clean.ps1 +++ b/bin/clean.ps1 @@ -4,11 +4,22 @@ #Requires -Version 5.1 [CmdletBinding()] param( + [Alias('dry-run')] [switch]$DryRun, + + [Alias('system')] [switch]$System, + + [Alias('game-media')] [switch]$GameMedia, + + [Alias('debug')] [switch]$DebugMode, + + [Alias('whitelist')] [switch]$Whitelist, + + [Alias('help')] [switch]$ShowHelp ) diff --git a/bin/optimize.ps1 b/bin/optimize.ps1 index 7c52361..cc220a9 100644 --- a/bin/optimize.ps1 +++ b/bin/optimize.ps1 @@ -4,15 +4,14 @@ #Requires -Version 5.1 [CmdletBinding()] param( + [Alias('dry-run')] [switch]$DryRun, + + [Alias('debug')] [switch]$DebugMode, - [switch]$ShowHelp, - # Repair options - [switch]$Repair, - [switch]$Font, - [switch]$Icon, - [switch]$Search, - [switch]$Store + + [Alias('help')] + [switch]$ShowHelp ) Set-StrictMode -Version Latest @@ -44,36 +43,25 @@ $script:IssuesFixed = 0 function Show-OptimizeHelp { $esc = [char]27 Write-Host "" - Write-Host "$esc[1;35mMole Optimize$esc[0m - System optimization, health checks, and repairs" + Write-Host "$esc[1;35mMole Optimize$esc[0m - System optimization and repairs" Write-Host "" - Write-Host "$esc[33mUsage:$esc[0m mole optimize [options]" + Write-Host "$esc[33mUsage:$esc[0m mo optimize [options]" Write-Host "" Write-Host "$esc[33mOptions:$esc[0m" - Write-Host " -DryRun Preview changes without applying" - Write-Host " -DebugMode Enable debug logging" - Write-Host " -ShowHelp Show this help message" + Write-Host " --dry-run Preview changes without applying" + Write-Host " --debug Enable debug logging" + Write-Host " --help Show this help message" Write-Host "" - Write-Host "$esc[33mRepair Options:$esc[0m" - Write-Host " -Repair Run all repairs (Font, Icon, Search, Store)" - Write-Host " -Font Rebuild font cache (fixes font display issues)" - Write-Host " -Icon Rebuild icon cache (fixes missing/corrupt icons)" - Write-Host " -Search Reset Windows Search index (fixes search issues)" - Write-Host " -Store Reset Windows Store cache (fixes Store issues)" + Write-Host "$esc[33mWhat it does:$esc[0m" + Write-Host " - Disk optimization (TRIM/Defrag)" + Write-Host " - Windows Search & Update check" + Write-Host " - Network & DNS optimization" + Write-Host " - System cache cleanup & repairs" + Write-Host " (Font cache, Icon cache, Store cache)" Write-Host "" Write-Host "$esc[33mExamples:$esc[0m" - Write-Host " mole optimize # Run standard optimizations" - Write-Host " mole optimize -Repair # Run optimizations + all repairs" - Write-Host " mole optimize -Icon -Font # Run optimizations + specific repairs" - Write-Host " mole optimize -DryRun # Preview what would happen" - Write-Host "" - Write-Host "$esc[33mOptimizations (always run):$esc[0m" - Write-Host " - Disk defragmentation/TRIM (SSD optimization)" - Write-Host " - Windows Search index check" - Write-Host " - DNS cache flush" - Write-Host " - Network optimization" - Write-Host " - Startup program analysis" - Write-Host " - Disk health check" - Write-Host " - Windows Update status" + Write-Host " mo optimize # Run all optimizations" + Write-Host " mo optimize --dry-run # Preview what would happen" Write-Host "" } @@ -86,38 +74,38 @@ function Get-SystemHealth { .SYNOPSIS Collect system health metrics #> - + $health = @{} - + # Memory info $os = Get-WmiObject Win32_OperatingSystem $health.MemoryTotalGB = [Math]::Round($os.TotalVisibleMemorySize / 1MB, 1) $health.MemoryUsedGB = [Math]::Round(($os.TotalVisibleMemorySize - $os.FreePhysicalMemory) / 1MB, 1) $health.MemoryUsedPercent = [Math]::Round((($os.TotalVisibleMemorySize - $os.FreePhysicalMemory) / $os.TotalVisibleMemorySize) * 100, 0) - + # Disk info $disk = Get-WmiObject Win32_LogicalDisk -Filter "DeviceID='$env:SystemDrive'" $health.DiskTotalGB = [Math]::Round($disk.Size / 1GB, 0) $health.DiskUsedGB = [Math]::Round(($disk.Size - $disk.FreeSpace) / 1GB, 0) $health.DiskUsedPercent = [Math]::Round((($disk.Size - $disk.FreeSpace) / $disk.Size) * 100, 0) - + # Uptime $uptime = (Get-Date) - (Get-CimInstance Win32_OperatingSystem).LastBootUpTime $health.UptimeDays = [Math]::Round($uptime.TotalDays, 1) - + # CPU info $cpu = Get-WmiObject Win32_Processor $health.CPUName = $cpu.Name $health.CPUCores = $cpu.NumberOfLogicalProcessors - + return $health } function Show-SystemHealth { param([hashtable]$Health) - + $esc = [char]27 - + Write-Host "$esc[34m$($script:Icons.Admin)$esc[0m System " -NoNewline Write-Host "$($Health.MemoryUsedGB)/$($Health.MemoryTotalGB)GB RAM | " -NoNewline Write-Host "$($Health.DiskUsedGB)/$($Health.DiskTotalGB)GB Disk | " -NoNewline @@ -133,28 +121,28 @@ function Optimize-DiskDrive { .SYNOPSIS Optimize disk (defrag for HDD, TRIM for SSD) #> - + $esc = [char]27 - + Write-Host "" Write-Host "$esc[34m$($script:Icons.Arrow) Disk Optimization$esc[0m" - + if (-not (Test-IsAdmin)) { Write-Host " $esc[33m$($script:Icons.Warning)$esc[0m Requires administrator privileges" return } - + if ($script:DryRun) { Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would optimize $env:SystemDrive" $script:OptimizationsApplied++ return } - + try { # Check if SSD or HDD $diskNumber = (Get-Partition -DriveLetter $env:SystemDrive[0]).DiskNumber $mediaType = (Get-PhysicalDisk | Where-Object { $_.DeviceId -eq $diskNumber }).MediaType - + if ($mediaType -eq "SSD") { Write-Host " Running TRIM on SSD..." $null = Optimize-Volume -DriveLetter $env:SystemDrive[0] -ReTrim -ErrorAction Stop @@ -177,27 +165,27 @@ function Optimize-SearchIndex { .SYNOPSIS Rebuild Windows Search index if needed #> - + $esc = [char]27 - + Write-Host "" Write-Host "$esc[34m$($script:Icons.Arrow) Windows Search$esc[0m" - + $searchService = Get-Service -Name WSearch -ErrorAction SilentlyContinue - + if (-not $searchService) { Write-Host " $esc[90mWindows Search service not found$esc[0m" return } - + if ($searchService.Status -ne 'Running') { Write-Host " $esc[33m$($script:Icons.Warning)$esc[0m Windows Search service is not running" - + if ($script:DryRun) { Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would start search service" return } - + try { Start-Service -Name WSearch -ErrorAction Stop Write-Host " $esc[32m$($script:Icons.Success)$esc[0m Started Windows Search service" @@ -217,18 +205,18 @@ function Clear-DnsCache { .SYNOPSIS Clear DNS resolver cache #> - + $esc = [char]27 - + Write-Host "" Write-Host "$esc[34m$($script:Icons.Arrow) DNS Cache$esc[0m" - + if ($script:DryRun) { Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would flush DNS cache" $script:OptimizationsApplied++ return } - + try { Clear-DnsClientCache -ErrorAction Stop Write-Host " $esc[32m$($script:Icons.Success)$esc[0m DNS cache flushed" @@ -244,24 +232,24 @@ function Optimize-Network { .SYNOPSIS Network stack optimization #> - + $esc = [char]27 - + Write-Host "" Write-Host "$esc[34m$($script:Icons.Arrow) Network Optimization$esc[0m" - + if (-not (Test-IsAdmin)) { Write-Host " $esc[33m$($script:Icons.Warning)$esc[0m Requires administrator privileges" return } - + if ($script:DryRun) { Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would reset Winsock catalog" Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would reset TCP/IP stack" $script:OptimizationsApplied += 2 return } - + try { # Reset Winsock $null = netsh winsock reset 2>&1 @@ -271,7 +259,7 @@ function Optimize-Network { catch { Write-Host " $esc[31m$($script:Icons.Error)$esc[0m Winsock reset failed" } - + try { # Flush ARP cache $null = netsh interface ip delete arpcache 2>&1 @@ -288,37 +276,37 @@ function Get-StartupPrograms { .SYNOPSIS Analyze startup programs #> - + $esc = [char]27 - + Write-Host "" Write-Host "$esc[34m$($script:Icons.Arrow) Startup Programs$esc[0m" - + $startupPaths = @( "HKCU:\SOFTWARE\Microsoft\Windows\CurrentVersion\Run" "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Run" "HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run" ) - + $startupCount = 0 - + foreach ($path in $startupPaths) { if (Test-Path $path) { $items = Get-ItemProperty -Path $path -ErrorAction SilentlyContinue - $props = @($items.PSObject.Properties | Where-Object { + $props = @($items.PSObject.Properties | Where-Object { $_.Name -notin @('PSPath', 'PSParentPath', 'PSChildName', 'PSDrive', 'PSProvider') }) $startupCount += $props.Count } } - + # Also check startup folder $startupFolder = "$env:APPDATA\Microsoft\Windows\Start Menu\Programs\Startup" if (Test-Path $startupFolder) { $startupFiles = @(Get-ChildItem -Path $startupFolder -File -ErrorAction SilentlyContinue) $startupCount += $startupFiles.Count } - + if ($startupCount -gt 10) { Write-Host " $esc[33m$($script:Icons.Warning)$esc[0m $startupCount startup programs (high)" Write-Host " $esc[90mConsider disabling unnecessary startup items in Task Manager$esc[0m" @@ -338,31 +326,31 @@ function Test-SystemFiles { .SYNOPSIS Run System File Checker (SFC) #> - + $esc = [char]27 - + Write-Host "" Write-Host "$esc[34m$($script:Icons.Arrow) System File Verification$esc[0m" - + if (-not (Test-IsAdmin)) { Write-Host " $esc[33m$($script:Icons.Warning)$esc[0m Requires administrator privileges" return } - + if ($script:DryRun) { Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would run System File Checker" return } - + Write-Host " Running System File Checker (this may take several minutes)..." - + try { $sfcResult = Start-Process -FilePath "sfc.exe" -ArgumentList "/scannow" ` -Wait -PassThru -NoNewWindow -RedirectStandardOutput "$env:TEMP\sfc_output.txt" -ErrorAction Stop - + $output = Get-Content "$env:TEMP\sfc_output.txt" -ErrorAction SilentlyContinue Remove-Item "$env:TEMP\sfc_output.txt" -Force -ErrorAction SilentlyContinue - + if ($output -match "did not find any integrity violations") { Write-Host " $esc[32m$($script:Icons.Success)$esc[0m No integrity violations found" } @@ -389,19 +377,19 @@ function Test-DiskHealth { .SYNOPSIS Check disk health status #> - + $esc = [char]27 - + Write-Host "" Write-Host "$esc[34m$($script:Icons.Arrow) Disk Health$esc[0m" - + try { $disks = Get-PhysicalDisk -ErrorAction Stop - + foreach ($disk in $disks) { $status = $disk.HealthStatus $name = $disk.FriendlyName - + if ($status -eq "Healthy") { Write-Host " $esc[32m$($script:Icons.Success)$esc[0m $name - Healthy" } @@ -427,23 +415,23 @@ function Test-WindowsUpdate { .SYNOPSIS Check Windows Update status #> - + $esc = [char]27 - + Write-Host "" Write-Host "$esc[34m$($script:Icons.Arrow) Windows Update$esc[0m" - + try { $updateSession = New-Object -ComObject Microsoft.Update.Session $updateSearcher = $updateSession.CreateUpdateSearcher() - + Write-Host " Checking for updates..." $searchResult = $updateSearcher.Search("IsInstalled=0") - - $importantUpdates = $searchResult.Updates | Where-Object { - $_.MsrcSeverity -in @('Critical', 'Important') + + $importantUpdates = $searchResult.Updates | Where-Object { + $_.MsrcSeverity -in @('Critical', 'Important') } - + if ($importantUpdates.Count -gt 0) { Write-Host " $esc[33m$($script:Icons.Warning)$esc[0m $($importantUpdates.Count) important updates available" Write-Host " $esc[90mRun Windows Update to install$esc[0m" @@ -473,24 +461,24 @@ function Repair-FontCache { Stops the font cache service, clears the cache files, and restarts. Fixes issues with fonts not displaying correctly or missing fonts. #> - + $esc = [char]27 - + Write-Host "" Write-Host "$esc[34m$($script:Icons.Arrow) Font Cache Rebuild$esc[0m" - + if (-not (Test-IsAdmin)) { Write-Host " $esc[33m$($script:Icons.Warning)$esc[0m Requires administrator privileges" return } - + # Font cache locations $fontCachePaths = @( "$env:LOCALAPPDATA\Microsoft\Windows\Fonts" "$env:WINDIR\ServiceProfiles\LocalService\AppData\Local\FontCache" "$env:WINDIR\System32\FNTCACHE.DAT" ) - + if ($script:DryRun) { Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would stop Windows Font Cache Service" Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would delete font cache files" @@ -498,21 +486,21 @@ function Repair-FontCache { $script:RepairsApplied++ return } - + try { # Stop font cache service Write-Host " $esc[90mStopping Font Cache Service...$esc[0m" Stop-Service -Name "FontCache" -Force -ErrorAction SilentlyContinue Stop-Service -Name "FontCache3.0.0.0" -Force -ErrorAction SilentlyContinue - + # Wait a moment for service to stop Start-Sleep -Seconds 2 - + # Delete font cache files foreach ($path in $fontCachePaths) { if (Test-Path $path) { if (Test-Path $path -PathType Container) { - Get-ChildItem -Path $path -Recurse -Force -ErrorAction SilentlyContinue | + Get-ChildItem -Path $path -Recurse -Force -ErrorAction SilentlyContinue | Remove-Item -Force -Recurse -ErrorAction SilentlyContinue } else { @@ -520,12 +508,12 @@ function Repair-FontCache { } } } - + # Restart font cache service Write-Host " $esc[90mRestarting Font Cache Service...$esc[0m" Start-Service -Name "FontCache" -ErrorAction SilentlyContinue Start-Service -Name "FontCache3.0.0.0" -ErrorAction SilentlyContinue - + Write-Host " $esc[32m$($script:Icons.Success)$esc[0m Font cache rebuilt successfully" Write-Host " $esc[90mNote: Some apps may need restart to see changes$esc[0m" $script:RepairsApplied++ @@ -544,14 +532,14 @@ function Repair-IconCache { Clears the icon cache database files, forcing Windows to rebuild them. Fixes issues with missing, corrupted, or outdated icons. #> - + $esc = [char]27 - + Write-Host "" Write-Host "$esc[34m$($script:Icons.Arrow) Icon Cache Rebuild$esc[0m" - + $iconCachePath = "$env:LOCALAPPDATA\Microsoft\Windows\Explorer" - + if ($script:DryRun) { Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would stop Explorer" Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would delete icon cache files (iconcache_*.db)" @@ -559,36 +547,36 @@ function Repair-IconCache { $script:RepairsApplied++ return } - + try { Write-Host " $esc[90mStopping Explorer...$esc[0m" Stop-Process -Name "explorer" -Force -ErrorAction SilentlyContinue Start-Sleep -Seconds 2 - + # Delete icon cache files $iconCacheFiles = Get-ChildItem -Path $iconCachePath -Filter "iconcache_*.db" -Force -ErrorAction SilentlyContinue $thumbCacheFiles = Get-ChildItem -Path $iconCachePath -Filter "thumbcache_*.db" -Force -ErrorAction SilentlyContinue - + $deletedCount = 0 foreach ($file in $iconCacheFiles) { Remove-Item -Path $file.FullName -Force -ErrorAction SilentlyContinue $deletedCount++ } - + foreach ($file in $thumbCacheFiles) { Remove-Item -Path $file.FullName -Force -ErrorAction SilentlyContinue $deletedCount++ } - + $systemIconCache = "$env:LOCALAPPDATA\IconCache.db" if (Test-Path $systemIconCache) { Remove-Item -Path $systemIconCache -Force -ErrorAction SilentlyContinue $deletedCount++ } - + Write-Host " $esc[90mRestarting Explorer...$esc[0m" Start-Process "explorer.exe" - + Write-Host " $esc[32m$($script:Icons.Success)$esc[0m Icon cache rebuilt ($deletedCount files cleared)" Write-Host " $esc[90mNote: Icons will rebuild gradually as you browse$esc[0m" $script:RepairsApplied++ @@ -607,19 +595,19 @@ function Repair-SearchIndex { Stops the Windows Search service, deletes the search index, and restarts. Fixes issues with search not finding files or returning incorrect results. #> - + $esc = [char]27 - + Write-Host "" Write-Host "$esc[34m$($script:Icons.Arrow) Windows Search Index Reset$esc[0m" - + if (-not (Test-IsAdmin)) { Write-Host " $esc[33m$($script:Icons.Warning)$esc[0m Requires administrator privileges" return } - + $searchIndexPath = "$env:ProgramData\Microsoft\Search\Data\Applications\Windows" - + if ($script:DryRun) { Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would stop Windows Search service" Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would delete search index database" @@ -627,20 +615,20 @@ function Repair-SearchIndex { $script:RepairsApplied++ return } - + try { Write-Host " $esc[90mStopping Windows Search service...$esc[0m" Stop-Service -Name "WSearch" -Force -ErrorAction Stop Start-Sleep -Seconds 3 - + if (Test-Path $searchIndexPath) { Write-Host " $esc[90mDeleting search index...$esc[0m" Remove-Item -Path "$searchIndexPath\*" -Recurse -Force -ErrorAction SilentlyContinue } - + Write-Host " $esc[90mRestarting Windows Search service...$esc[0m" Start-Service -Name "WSearch" -ErrorAction Stop - + Write-Host " $esc[32m$($script:Icons.Success)$esc[0m Search index reset successfully" Write-Host " $esc[33m$($script:Icons.Warning)$esc[0m Indexing will rebuild in the background (may take hours)" $script:RepairsApplied++ @@ -659,23 +647,23 @@ function Repair-StoreCache { Runs wsreset.exe to clear the Windows Store cache. Fixes issues with Store apps not installing, updating, or launching. #> - + $esc = [char]27 - + Write-Host "" Write-Host "$esc[34m$($script:Icons.Arrow) Windows Store Cache Reset$esc[0m" - + if ($script:DryRun) { Write-Host " $esc[33m$($script:Icons.DryRun)$esc[0m Would run wsreset.exe" $script:RepairsApplied++ return } - + try { Write-Host " $esc[90mResetting Windows Store cache...$esc[0m" $wsreset = Start-Process -FilePath "wsreset.exe" -PassThru -WindowStyle Hidden $wsreset.WaitForExit(30000) - + if ($wsreset.ExitCode -eq 0) { Write-Host " $esc[32m$($script:Icons.Success)$esc[0m Windows Store cache reset successfully" } @@ -695,7 +683,7 @@ function Repair-StoreCache { function Show-OptimizeSummary { $esc = [char]27 - + Write-Host "" Write-Host "$esc[1;35m" -NoNewline if ($script:DryRun) { @@ -706,7 +694,7 @@ function Show-OptimizeSummary { } Write-Host "$esc[0m" Write-Host "" - + if ($script:DryRun) { $total = $script:OptimizationsApplied + $script:RepairsApplied Write-Host " Would apply $esc[33m$total$esc[0m changes" @@ -717,15 +705,15 @@ function Show-OptimizeSummary { } else { Write-Host " Optimizations applied: $esc[32m$($script:OptimizationsApplied)$esc[0m" - + if ($script:RepairsApplied -gt 0) { Write-Host " Repairs applied: $esc[32m$($script:RepairsApplied)$esc[0m" } - + if ($script:IssuesFixed -gt 0) { Write-Host " Issues fixed: $esc[32m$($script:IssuesFixed)$esc[0m" } - + if ($script:IssuesFound -gt 0) { Write-Host " Issues found: $esc[33m$($script:IssuesFound)$esc[0m" } @@ -733,7 +721,7 @@ function Show-OptimizeSummary { Write-Host " System health: $esc[32mGood$esc[0m" } } - + Write-Host "" } @@ -747,78 +735,62 @@ function Main { $env:MOLE_DEBUG = "1" $DebugPreference = "Continue" } - + # Show help if ($ShowHelp) { Show-OptimizeHelp return } - + # Set dry-run mode $script:DryRun = $DryRun - - # Check if any repairs were requested - $runRepairs = $Repair -or $Font -or $Icon -or $Search -or $Store - + # Clear screen Clear-Host - + $esc = [char]27 Write-Host "" Write-Host "$esc[1;35mOptimize and Check$esc[0m" Write-Host "" - + if ($script:DryRun) { Write-Host "$esc[33m$($script:Icons.DryRun) DRY RUN MODE$esc[0m - No changes will be made" Write-Host "" } - + # Show system health $health = Get-SystemHealth Show-SystemHealth -Health $health - + # Run optimizations Optimize-DiskDrive Optimize-SearchIndex Clear-DnsCache Optimize-Network - + # Run health checks Get-StartupPrograms Test-DiskHealth Test-WindowsUpdate - - # Run repairs if requested - if ($runRepairs) { - Write-Host "" - Write-Host "$esc[1;35m$($script:Icons.Arrow) Repairs$esc[0m" - - if ($Repair -or $Font) { - Repair-FontCache - } - - if ($Repair -or $Icon) { - Repair-IconCache - } - - if ($Repair -or $Search) { - Repair-SearchIndex - } - - if ($Repair -or $Store) { - Repair-StoreCache - } - } - - # System file check is slow, ask first (only if not doing repairs) - if (-not $runRepairs -and -not $script:DryRun -and (Test-IsAdmin)) { + + # Run repairs (consolidated) + Write-Host "" + Write-Host "$esc[34m$($script:Icons.Arrow) System Repairs$esc[0m" + + Repair-FontCache + Repair-StoreCache + Repair-SearchIndex + Repair-IconCache + + # System file check is slow, ask first + if (-not $script:DryRun -and (Test-IsAdmin)) { Write-Host "" $runSfc = Read-Host "Run System File Checker? This may take several minutes (y/N)" if ($runSfc -eq 'y' -or $runSfc -eq 'Y') { Test-SystemFiles } } - + # Summary Show-OptimizeSummary } diff --git a/bin/purge.ps1 b/bin/purge.ps1 index 2d1f4ba..ecba5d8 100644 --- a/bin/purge.ps1 +++ b/bin/purge.ps1 @@ -4,8 +4,13 @@ #Requires -Version 5.1 [CmdletBinding()] param( + [Alias('debug')] [switch]$DebugMode, + + [Alias('paths')] [switch]$Paths, + + [Alias('help')] [switch]$ShowHelp ) diff --git a/mole.ps1 b/mole.ps1 index e82f4af..b2f73a8 100644 --- a/mole.ps1 +++ b/mole.ps1 @@ -57,37 +57,33 @@ function Show-MainHelp { Write-Host "" Write-Host " ${green}COMMANDS:${nc}" Write-Host "" - Write-Host " ${cyan}clean${nc} Deep system cleanup (caches, temp, logs)" + Write-Host " ${cyan}clean${nc} Deep system cleanup" Write-Host " ${cyan}uninstall${nc} Smart application uninstaller" - Write-Host " ${cyan}analyze${nc} Visual disk space analyzer" - Write-Host " ${cyan}status${nc} Real-time system monitor" Write-Host " ${cyan}optimize${nc} System optimization and repairs" - Write-Host " ${cyan}purge${nc} Clean project build artifacts" + Write-Host " ${cyan}analyze${nc} Disk space analyzer" + Write-Host " ${cyan}status${nc} System monitor" + Write-Host " ${cyan}purge${nc} Clean project artifacts" Write-Host "" Write-Host " ${green}OPTIONS:${nc}" Write-Host "" - Write-Host " ${cyan}-Version${nc} Show version information" - Write-Host " ${cyan}-ShowHelp${nc} Show this help message" + Write-Host " ${cyan}--version${nc} Show version information" + Write-Host " ${cyan}--help${nc} Show this help message" Write-Host "" Write-Host " ${green}EXAMPLES:${nc}" Write-Host "" - Write-Host " ${gray}mole${nc} ${gray}# Interactive menu${nc}" - Write-Host " ${gray}mole clean${nc} ${gray}# Deep cleanup${nc}" - Write-Host " ${gray}mole clean -DryRun${nc} ${gray}# Preview cleanup${nc}" - Write-Host " ${gray}mole uninstall${nc} ${gray}# Uninstall apps${nc}" - Write-Host " ${gray}mole analyze${nc} ${gray}# Disk analyzer${nc}" - Write-Host " ${gray}mole status${nc} ${gray}# System monitor${nc}" - Write-Host " ${gray}mole optimize${nc} ${gray}# Optimize system${nc}" - Write-Host " ${gray}mole optimize -Repair${nc} ${gray}# Optimize + all repairs${nc}" - Write-Host " ${gray}mole optimize -Icon${nc} ${gray}# Optimize + rebuild icons${nc}" - Write-Host " ${gray}mole purge${nc} ${gray}# Clean dev artifacts${nc}" + Write-Host " ${gray}mo${nc} ${gray}# Interactive menu${nc}" + Write-Host " ${gray}mo clean${nc} ${gray}# Deep cleanup${nc}" + Write-Host " ${gray}mo clean --dry-run${nc} ${gray}# Preview cleanup${nc}" + Write-Host " ${gray}mo optimize${nc} ${gray}# Optimize system${nc}" + Write-Host " ${gray}mo optimize --dry-run${nc} ${gray}# Preview optimization${nc}" + Write-Host " ${gray}mo uninstall${nc} ${gray}# Uninstall apps${nc}" Write-Host "" Write-Host " ${green}ENVIRONMENT:${nc}" Write-Host "" Write-Host " ${cyan}MOLE_DRY_RUN=1${nc} Preview without changes" Write-Host " ${cyan}MOLE_DEBUG=1${nc} Enable debug output" Write-Host "" - Write-Host " ${gray}Run '${nc}mole -ShowHelp${gray}' for command-specific help${nc}" + Write-Host " ${gray}Run '${nc}mo --help${gray}' for command-specific help${nc}" Write-Host "" } @@ -103,6 +99,12 @@ function Show-MainMenu { Command = "clean" Icon = $script:Icons.Trash } + @{ + Name = "Optimize" + Description = "Optimization & repairs" + Command = "optimize" + Icon = $script:Icons.Arrow + } @{ Name = "Uninstall" Description = "Remove applications" @@ -121,12 +123,6 @@ function Show-MainMenu { Command = "status" Icon = $script:Icons.Solid } - @{ - Name = "Optimize" - Description = "Optimization & repairs" - Command = "optimize" - Icon = $script:Icons.Arrow - } @{ Name = "Purge" Description = "Clean dev artifacts" @@ -159,7 +155,7 @@ function Invoke-MoleCommand { if (-not (Test-Path $scriptPath)) { Write-MoleError "Unknown command: $CommandName" Write-Host "" - Write-Host "Run 'mole -ShowHelp' for available commands" + Write-Host "Run 'mo --help' for available commands" return } @@ -175,13 +171,13 @@ function Invoke-MoleCommand { # Remove surrounding quotes if present $cleanArg = $arg.Trim("'`"") - if ($cleanArg -match '^-(\w+)$') { - # It's a switch parameter (e.g., -DryRun) + if ($cleanArg -match '^-{1,2}([\w-]+)$') { + # It's a switch parameter (e.g., -DryRun or --dry-run) $paramName = $Matches[1] $splatParams[$paramName] = $true } - elseif ($cleanArg -match '^-(\w+)[=:](.+)$') { - # It's a named parameter with value (e.g., -Name=Value or -Name:Value) + elseif ($cleanArg -match '^-{1,2}([\w-]+)[=:](.+)$') { + # It's a named parameter with value (e.g., --name=value) $paramName = $Matches[1] $paramValue = $Matches[2].Trim("'`"") $splatParams[$paramName] = $paramValue