1
0
mirror of https://github.com/tw93/Mole.git synced 2026-02-04 17:24:45 +00:00

Initial commit: Clean Mac v1.0.0

🧹 Deep Clean Your Mac with One Click

Features:
- Comprehensive cleanup for macOS cache and leftovers
- Apple Silicon optimizations
- Developer-friendly tool coverage
- Safe and transparent operation
- One-command installation
This commit is contained in:
Tw93
2025-09-23 14:32:12 +08:00
commit 6402ac3f4a
6 changed files with 1112 additions and 0 deletions

729
clean.sh Executable file
View File

@@ -0,0 +1,729 @@
#!/bin/bash
# Clean Mac - Deep Clean Your Mac with One Click
#
# 🧹 One-click cleanup tool for macOS cache and leftovers
# 🍎 Optimized for Apple Silicon with comprehensive dev tool support
#
# Quick install:
# curl -fsSL https://raw.githubusercontent.com/tw93/clean-mac/main/install.sh | bash
#
# Usage:
# clean # Daily cleanup (safe, no password)
# clean --system # Deep system cleanup (requires password)
# clean --help # Show help information
#
# GitHub: https://github.com/tw93/clean-mac
# License: MIT © tw93
# ANSI color palette
GREEN='\033[0;32m'
BLUE='\033[0;34m'
YELLOW='\033[1;33m'
PURPLE='\033[0;35m'
RED='\033[0;31m'
NC='\033[0m'
log_info() { echo -e "${BLUE}$1${NC}"; }
log_success() { echo -e "${GREEN}$1${NC}"; }
log_warning() { echo -e "${YELLOW}⚠️ $1${NC}"; }
log_error() { echo -e "${RED}$1${NC}"; }
log_header() { echo -e "\n${PURPLE}$1${NC}"; }
PRESERVED_BUNDLE_PATTERNS=(
"com.apple.*"
"com.nektony.*"
)
if [[ -n "$CLEAN_PRESERVE_BUNDLES" ]]; then
IFS=',' read -r -a extra_patterns <<< "$CLEAN_PRESERVE_BUNDLES"
PRESERVED_BUNDLE_PATTERNS+=("${extra_patterns[@]}")
fi
should_preserve_bundle() {
local bundle_id="$1"
for pattern in "${PRESERVED_BUNDLE_PATTERNS[@]}"; do
if [[ "$bundle_id" == $pattern ]]; then
return 0
fi
done
return 1
}
LAST_CLEAN_RESULT=0
SECTION_ACTIVITY=0
TRACK_SECTION=0
SUDO_KEEPALIVE_PID=""
note_activity() {
if [[ $TRACK_SECTION -eq 1 ]]; then
SECTION_ACTIVITY=1
fi
}
cleanup() {
if [[ -n "$SUDO_KEEPALIVE_PID" ]]; then
kill "$SUDO_KEEPALIVE_PID" 2>/dev/null || true
SUDO_KEEPALIVE_PID=""
fi
}
trap cleanup EXIT INT TERM
start_section() {
TRACK_SECTION=1
SECTION_ACTIVITY=0
log_header "$1"
}
end_section() {
if [[ $TRACK_SECTION -eq 1 && $SECTION_ACTIVITY -eq 0 ]]; then
echo -e " ${BLUE}${NC} Nothing to tidy"
fi
TRACK_SECTION=0
}
# Configuration
SYSTEM_CLEAN=false
# Argument parsing
while [[ $# -gt 0 ]]; do
case $1 in
--help|-h)
echo "Usage: clean [OPTIONS]"
echo ""
echo "Description: Clean Mac - Deep Clean Your Mac with One Click"
echo ""
echo "Options:"
echo " --system Include system-level cleanup (requires password)"
echo " --help Show this help message"
echo ""
echo "Default: Cleans user-level cache and data (no password required)"
exit 0
;;
--system)
SYSTEM_CLEAN=true
shift
;;
*)
log_error "Unknown option: $1"
echo "Use --help to view available options"
exit 1
;;
esac
done
# Detect Mac architecture
ARCH=$(uname -m)
IS_M_SERIES=false
if [[ "$ARCH" == "arm64" ]]; then
IS_M_SERIES=true
fi
# Privilege escalation helper
request_sudo() {
if [[ "$SKIP_SYSTEM" == "true" ]]; then
return 0
fi
log_info "Administrator privileges are required for system-level cleanup..."
if ! sudo -v; then
log_warning "System-level cleanup skipped (sudo unavailable)"
SKIP_SYSTEM=true
return 1
fi
# Keep sudo session alive
while true; do sudo -n true; sleep 60; kill -0 "$$" 2>/dev/null || exit; done 2>/dev/null &
SUDO_KEEPALIVE_PID=$!
}
# Safe cleanup helper
safe_clean() {
if [[ $# -eq 0 ]]; then
return 0
fi
local description
local -a targets
if [[ $# -eq 1 ]]; then
description="$1"
targets=("$1")
else
description="${@: -1}"
targets=("${@:1:$#-1}")
fi
local removed_any=0
for path in "${targets[@]}"; do
if [[ ! -e "$path" ]]; then
continue
fi
local size_bytes=$(du -sk "$path" 2>/dev/null | awk '{print $1}' || echo "0")
local size_human=$(du -sh "$path" 2>/dev/null | awk '{print $1}' || echo "0B")
local count=$(find "$path" -type f 2>/dev/null | wc -l | tr -d ' ')
if [[ "$count" -eq 0 || "$size_bytes" -eq 0 ]]; then
continue
fi
rm -rf "$path" 2>/dev/null || true
local label="$description"
if [[ ${#targets[@]} -gt 1 ]]; then
label+=" [$(basename "$path")"]
fi
echo -e " ${GREEN}${NC} $label ${GREEN}($size_human)${NC}"
((files_cleaned+=count))
((total_size_cleaned+=size_bytes))
((total_items++))
removed_any=1
note_activity
done
LAST_CLEAN_RESULT=$removed_any
return $removed_any
}
# Prompt before cleaning non-cache application data
confirm_clean() {
local path="$1"
local description="${2:-$path}"
local app_name="$3"
if [[ ! -e "$path" ]]; then
return 0
fi
local size_human=$(du -sh "$path" 2>/dev/null | cut -f1 || echo "0B")
local count=$(find "$path" -type f 2>/dev/null | wc -l | tr -d ' ')
if [[ "$count" -gt 0 ]]; then
echo -e " ${YELLOW}⚠️${NC} Found $app_name data: ${GREEN}($size_human)${NC}"
read -p " Clean $app_name data? (y/N): " -n 1 -r
echo
if [[ $REPLY =~ ^[Yy]$ ]]; then
safe_clean "$path" "$description"
else
echo -e " ${BLUE}${NC} Skipped $app_name data"
fi
fi
}
# Detect orphaned application leftovers
check_orphaned_apps() {
log_header "Checking for orphaned app files"
# Build a list of installed application bundle identifiers
local installed_bundles=$(mktemp)
find /Applications -name "*.app" -exec sh -c 'defaults read "$1/Contents/Info.plist" CFBundleIdentifier 2>/dev/null' _ {} \; > "$installed_bundles" 2>/dev/null
local found_orphaned=false
# Inspect the Caches directory
find ~/Library/Caches -maxdepth 1 -name "com.*" -type d | while read cache_dir; do
local bundle_id=$(basename "$cache_dir")
if should_preserve_bundle "$bundle_id"; then
continue
fi
if ! grep -q "$bundle_id" "$installed_bundles"; then
safe_clean "$cache_dir" "Orphaned cache: $bundle_id"
found_orphaned=true
fi
done
# Inspect the Application Support directory
find ~/Library/Application\ Support -maxdepth 1 -name "com.*" -type d | while read support_dir; do
local bundle_id=$(basename "$support_dir")
if should_preserve_bundle "$bundle_id"; then
continue
fi
if ! grep -q "$bundle_id" "$installed_bundles"; then
safe_clean "$support_dir" "Orphaned data: $bundle_id"
found_orphaned=true
fi
done
# Inspect the Preferences directory
find ~/Library/Preferences -maxdepth 1 -name "com.*.plist" -type f | while read pref_file; do
local bundle_id=$(basename "$pref_file" .plist)
if should_preserve_bundle "$bundle_id"; then
continue
fi
if ! grep -q "$bundle_id" "$installed_bundles"; then
safe_clean "$pref_file" "Orphaned preference: $bundle_id"
found_orphaned=true
fi
done
if [[ "$found_orphaned" == "false" ]]; then
echo -e " ${GREEN}${NC} No orphaned files found"
fi
rm -f "$installed_bundles"
}
# Apple Silicon specific cache cleanup
clean_command_cache() {
if [[ "$IS_M_SERIES" == "true" ]]; then
local silicon_cleaned=0
# Rosetta 2 cache
safe_clean /Library/Apple/usr/share/rosetta/rosetta_update_bundle "Rosetta 2 cache"
((silicon_cleaned |= LAST_CLEAN_RESULT))
safe_clean ~/Library/Caches/com.apple.rosetta.update "Rosetta 2 user cache"
((silicon_cleaned |= LAST_CLEAN_RESULT))
# Additional Apple Silicon caches
safe_clean ~/Library/Caches/com.apple.amp.mediasevicesd "Apple Silicon media service cache"
((silicon_cleaned |= LAST_CLEAN_RESULT))
safe_clean ~/Library/Caches/com.apple.bird.lsuseractivity "User activity cache"
((silicon_cleaned |= LAST_CLEAN_RESULT))
if [[ $silicon_cleaned -eq 0 ]]; then
echo -e " ${BLUE}${NC} Apple Silicon caches are already tidy"
fi
fi
}
echo "🧹 Clean Mac - Deep Clean Your Mac with One Click"
echo "================================================"
space_before=$(df / | tail -1 | awk '{print $4}')
current_space=$(df -h / | tail -1 | awk '{print $4}')
if [[ "$IS_M_SERIES" == "true" ]]; then
echo "🍎 Detected: Apple Silicon (M-series) | 💾 Free space: $current_space"
else
echo "💻 Detected: Intel Mac | 💾 Free space: $current_space"
fi
if [[ "$SYSTEM_CLEAN" == "true" ]]; then
echo "🚀 Mode: Full cleanup (user + system)"
else
echo "🚀 Mode: User-level cleanup (no password required)"
fi
# Initialize counters
total_items=0
files_cleaned=0
total_size_cleaned=0
# ===== 1. System essentials =====
start_section "System essentials"
safe_clean ~/Library/Caches/* "User app cache"
safe_clean ~/Library/Logs/* "User app logs"
safe_clean ~/.Trash/* "Trash"
# Empty the trash on all mounted volumes
for volume in /Volumes/*; do
[[ -d "$volume/.Trashes" ]] && safe_clean "$volume/.Trashes"/* "External volume trash"
done
safe_clean ~/Library/Application\ Support/CrashReporter/* "Crash reports"
safe_clean ~/Library/DiagnosticReports/* "Diagnostic reports"
safe_clean ~/Library/Caches/com.apple.QuickLook.thumbnailcache "QuickLook thumbnails"
safe_clean ~/Library/Caches/Quick\ Look/* "QuickLook cache"
safe_clean ~/Library/Caches/com.apple.LaunchServices* "Launch services cache"
safe_clean ~/Library/Caches/com.apple.iconservices* "Icon services cache"
safe_clean ~/Library/Caches/CloudKit/* "CloudKit cache"
safe_clean ~/Library/Caches/com.apple.bird* "iCloud cache"
end_section
# ===== 2. Browsers =====
start_section "Browser cleanup"
# Safari
safe_clean ~/Library/Caches/com.apple.Safari/* "Safari cache"
safe_clean ~/Library/Safari/LocalStorage/* "Safari local storage"
safe_clean ~/Library/Safari/Databases/* "Safari databases"
# Chrome/Chromium family
safe_clean ~/Library/Caches/Google/Chrome/* "Chrome cache"
safe_clean ~/Library/Application\ Support/Google/Chrome/*/Application\ Cache/* "Chrome app cache"
safe_clean ~/Library/Application\ Support/Google/Chrome/*/GPUCache/* "Chrome GPU cache"
safe_clean ~/Library/Caches/Chromium/* "Chromium cache"
# Other browsers
safe_clean ~/Library/Caches/com.microsoft.edgemac/* "Edge cache"
safe_clean ~/Library/Caches/company.thebrowser.Browser/* "Arc cache"
safe_clean ~/Library/Caches/BraveSoftware/Brave-Browser/* "Brave cache"
safe_clean ~/Library/Caches/Firefox/* "Firefox cache"
safe_clean ~/Library/Caches/com.operasoftware.Opera/* "Opera cache"
safe_clean ~/Library/Caches/com.vivaldi.Vivaldi/* "Vivaldi cache"
end_section
# ===== 3. Developer tools =====
start_section "Developer tools"
# Node.js ecosystem
if command -v npm >/dev/null 2>&1; then
npm cache clean --force >/dev/null 2>&1 || true
echo -e " ${GREEN}${NC} npm cache cleaned"
note_activity
fi
safe_clean ~/.npm/_cacache/* "npm cache directory"
safe_clean ~/.yarn/cache/* "Yarn cache"
safe_clean ~/.bun/install/cache/* "Bun cache"
# Python ecosystem
if command -v pip3 >/dev/null 2>&1; then
pip3 cache purge >/dev/null 2>&1 || true
echo -e " ${GREEN}${NC} pip cache cleaned"
note_activity
fi
safe_clean ~/Library/Caches/pip/* "pip cache directory"
safe_clean ~/.pyenv/cache/* "pyenv cache"
# Go tooling
if command -v go >/dev/null 2>&1; then
go clean -modcache >/dev/null 2>&1 || true
go clean -cache >/dev/null 2>&1 || true
echo -e " ${GREEN}${NC} Go cache cleaned"
note_activity
fi
# Homebrew cleanup
safe_clean ~/Library/Caches/Homebrew/* "Homebrew cache"
safe_clean /opt/homebrew/var/homebrew/locks/* "Homebrew lock files (M series)"
safe_clean /usr/local/var/homebrew/locks/* "Homebrew lock files (Intel)"
# Docker
if command -v docker >/dev/null 2>&1; then
docker system prune -af --volumes >/dev/null 2>&1 || true
echo -e " ${GREEN}${NC} Docker resources cleaned"
note_activity
fi
# Container tools
safe_clean ~/.kube/cache/* "Kubernetes cache"
if command -v podman >/dev/null 2>&1; then
podman system prune -af --volumes >/dev/null 2>&1 || true
echo -e " ${GREEN}${NC} Podman resources cleaned"
note_activity
fi
safe_clean ~/.local/share/containers/storage/tmp/* "Container storage temp"
# Cloud CLI tools
safe_clean ~/.aws/cli/cache/* "AWS CLI cache"
safe_clean ~/.config/gcloud/logs/* "Google Cloud logs"
safe_clean ~/.azure/logs/* "Azure CLI logs"
end_section
# ===== 4. Applications =====
start_section "Applications"
# Xcode & iOS development
safe_clean ~/Library/Developer/Xcode/DerivedData/* "Xcode derived data"
safe_clean ~/Library/Developer/Xcode/Archives/* "Xcode archives"
safe_clean ~/Library/Developer/CoreSimulator/Caches/* "Simulator cache"
safe_clean ~/Library/Developer/CoreSimulator/Devices/*/data/tmp/* "Simulator temp files"
safe_clean ~/Library/Caches/com.apple.dt.Xcode/* "Xcode cache"
# VS Code family
safe_clean ~/Library/Application\ Support/Code/logs/* "VS Code logs"
safe_clean ~/Library/Application\ Support/Code/CachedExtensions/* "VS Code extension cache"
safe_clean ~/Library/Application\ Support/Code/CachedData/* "VS Code data cache"
# JetBrains IDEs
safe_clean ~/Library/Logs/IntelliJIdea*/* "IntelliJ IDEA logs"
safe_clean ~/Library/Logs/PhpStorm*/* "PhpStorm logs"
safe_clean ~/Library/Logs/PyCharm*/* "PyCharm logs"
safe_clean ~/Library/Logs/WebStorm*/* "WebStorm logs"
safe_clean ~/Library/Logs/GoLand*/* "GoLand logs"
safe_clean ~/Library/Logs/CLion*/* "CLion logs"
safe_clean ~/Library/Logs/DataGrip*/* "DataGrip logs"
safe_clean ~/Library/Caches/JetBrains/* "JetBrains cache"
# Communication and social apps
safe_clean ~/Library/Application\ Support/discord/Cache/* "Discord cache"
safe_clean ~/Library/Application\ Support/Slack/Cache/* "Slack cache"
safe_clean ~/Library/Caches/us.zoom.xos/* "Zoom cache"
safe_clean ~/Library/Caches/com.tencent.xinWeChat/* "WeChat cache"
safe_clean ~/Library/Caches/ru.keepcoder.Telegram/* "Telegram cache"
safe_clean ~/Library/Caches/com.openai.chat/* "ChatGPT cache"
safe_clean ~/Library/Caches/com.anthropic.claudefordesktop/* "Claude desktop cache"
safe_clean ~/Library/Logs/Claude/* "Claude logs"
safe_clean ~/Library/Caches/com.microsoft.teams2/* "Microsoft Teams cache"
safe_clean ~/Library/Caches/net.whatsapp.WhatsApp/* "WhatsApp cache"
safe_clean ~/Library/Caches/com.skype.skype/* "Skype cache"
# Design and creative software
safe_clean ~/Library/Caches/com.bohemiancoding.sketch3/* "Sketch cache"
safe_clean ~/Library/Application\ Support/com.bohemiancoding.sketch3/cache/* "Sketch app cache"
safe_clean ~/Library/Caches/net.telestream.screenflow10/* "ScreenFlow cache"
# Productivity and dev utilities
safe_clean ~/Library/Caches/com.raycast.macos/* "Raycast cache"
safe_clean ~/Library/Caches/com.tw93.MiaoYan/* "MiaoYan cache"
safe_clean ~/Library/Caches/com.filo.client/* "Filo cache"
safe_clean ~/Library/Caches/com.flomoapp.mac/* "Flomo cache"
# Music and entertainment
safe_clean ~/Library/Caches/com.spotify.client/* "Spotify cache"
# Gaming and entertainment
safe_clean ~/Library/Caches/com.valvesoftware.steam/* "Steam cache"
safe_clean ~/Library/Caches/com.epicgames.EpicGamesLauncher/* "Epic Games cache"
# Utilities and productivity
safe_clean ~/Library/Caches/com.nektony.App-Cleaner-SIIICn/* "App Cleaner cache"
safe_clean ~/Library/Caches/com.runjuu.Input-Source-Pro/* "Input Source Pro cache"
safe_clean ~/Library/Caches/macos-wakatime.WakaTime/* "WakaTime cache"
safe_clean ~/Library/Caches/notion.id/* "Notion cache"
safe_clean ~/Library/Caches/md.obsidian/* "Obsidian cache"
safe_clean ~/Library/Caches/com.1password.*/* "1Password cache"
safe_clean ~/Library/Caches/com.runningwithcrayons.Alfred/* "Alfred cache"
safe_clean ~/Library/Caches/cx.c3.theunarchiver/* "The Unarchiver cache"
safe_clean ~/Library/Caches/com.freemacsoft.AppCleaner/* "AppCleaner cache"
end_section
# ===== 5. Orphaned leftovers =====
check_orphaned_apps
# Common temp and test data
safe_clean ~/Library/Application\ Support/TestApp* "Test app data"
safe_clean ~/Library/Application\ Support/MyApp/* "Test app data"
safe_clean ~/Library/Application\ Support/GitHub*/* "GitHub test data"
safe_clean ~/Library/Application\ Support/Twitter*/* "Twitter test data"
safe_clean ~/Library/Application\ Support/TestNoValue/* "Test data"
safe_clean ~/Library/Application\ Support/Wk*/* "Test data"
# ===== 6. Apple Silicon specific =====
if [[ "$IS_M_SERIES" == "true" ]]; then
log_header "Apple Silicon cache cleanup"
clean_command_cache
fi
# ===== 6. Extended dev caches =====
start_section "Extended developer caches"
# Additional Node.js and frontend tools
safe_clean ~/.pnpm-store/* "pnpm store cache"
safe_clean ~/.cache/typescript/* "TypeScript cache"
safe_clean ~/.cache/electron/* "Electron cache"
safe_clean ~/.cache/yarn/* "Yarn cache"
safe_clean ~/.turbo/* "Turbo cache"
safe_clean ~/.next/* "Next.js cache"
safe_clean ~/.vite/* "Vite cache"
safe_clean ~/.cache/vite/* "Vite global cache"
safe_clean ~/.cache/webpack/* "Webpack cache"
safe_clean ~/.parcel-cache/* "Parcel cache"
# Design and development tools
safe_clean ~/Library/Caches/Google/AndroidStudio*/* "Android Studio cache"
safe_clean ~/Library/Caches/com.unity3d.*/* "Unity cache"
safe_clean ~/Library/Caches/com.postmanlabs.mac/* "Postman cache"
safe_clean ~/Library/Caches/com.konghq.insomnia/* "Insomnia cache"
safe_clean ~/Library/Caches/com.tinyapp.TablePlus/* "TablePlus cache"
safe_clean ~/Library/Caches/com.mongodb.compass/* "MongoDB Compass cache"
safe_clean ~/Library/Caches/com.figma.Desktop/* "Figma cache"
safe_clean ~/Library/Caches/com.github.GitHubDesktop/* "GitHub Desktop cache"
safe_clean ~/Library/Caches/com.microsoft.VSCode/* "VS Code cache"
safe_clean ~/Library/Caches/com.sublimetext.*/* "Sublime Text cache"
# Python tooling
safe_clean ~/.cache/poetry/* "Poetry cache"
safe_clean ~/.cache/uv/* "uv cache"
safe_clean ~/.cache/ruff/* "Ruff cache"
safe_clean ~/.cache/mypy/* "MyPy cache"
safe_clean ~/.pytest_cache/* "Pytest cache"
# AI/ML and Data Science tools
safe_clean ~/.jupyter/runtime/* "Jupyter runtime cache"
safe_clean ~/.cache/huggingface/* "Hugging Face cache"
safe_clean ~/.cache/torch/* "PyTorch cache"
safe_clean ~/.cache/tensorflow/* "TensorFlow cache"
safe_clean ~/.conda/pkgs/* "Conda packages cache"
safe_clean ~/anaconda3/pkgs/* "Anaconda packages cache"
safe_clean ~/.cache/wandb/* "Weights & Biases cache"
# Rust tooling
safe_clean ~/.cargo/registry/cache/* "Cargo registry cache"
safe_clean ~/.cargo/git/* "Cargo git cache"
# Java tooling
safe_clean ~/.gradle/caches/* "Gradle caches"
safe_clean ~/.m2/repository/* "Maven repository cache"
safe_clean ~/.sbt/* "SBT cache"
# Git and version control
safe_clean ~/.cache/pre-commit/* "pre-commit cache"
safe_clean ~/.gitconfig.bak* "Git config backup"
# Mobile development
safe_clean ~/.cache/flutter/* "Flutter cache"
safe_clean ~/.gradle/daemon/* "Gradle daemon logs"
safe_clean ~/Library/Developer/Xcode/iOS\ DeviceSupport/*/Symbols/System/Library/Caches/* "iOS device cache"
safe_clean ~/.android/cache/* "Android SDK cache"
# Other language tool caches
safe_clean ~/.cache/swift-package-manager/* "Swift package manager cache"
safe_clean ~/.cache/bazel/* "Bazel cache"
safe_clean ~/.cache/zig/* "Zig cache"
safe_clean ~/.cache/deno/* "Deno cache"
# Database tools
safe_clean ~/Library/Caches/com.sequel-ace.sequel-ace/* "Sequel Ace cache"
safe_clean ~/Library/Caches/com.eggerapps.Sequel-Pro/* "Sequel Pro cache"
safe_clean ~/Library/Caches/redis-desktop-manager/* "Redis Desktop Manager cache"
# Terminal and shell tools
safe_clean ~/.oh-my-zsh/cache/* "Oh My Zsh cache"
safe_clean ~/.config/fish/fish_history.bak* "Fish shell backup"
safe_clean ~/.bash_history.bak* "Bash history backup"
safe_clean ~/.zsh_history.bak* "Zsh history backup"
# Code quality and analysis
safe_clean ~/.sonar/* "SonarQube cache"
safe_clean ~/.cache/eslint/* "ESLint cache"
safe_clean ~/.cache/prettier/* "Prettier cache"
# Additional system-level caches
safe_clean ~/Library/Caches/SentryCrash/* "Sentry crash reports"
safe_clean ~/Library/Caches/KSCrash/* "KSCrash reports"
safe_clean ~/Library/Caches/com.crashlytics.data/* "Crashlytics data"
safe_clean ~/Library/Saved\ Application\ State/* "App state files"
safe_clean ~/Library/HTTPStorages/* "HTTP storage cache"
# Network and download caches
safe_clean ~/Library/Caches/curl/* "curl cache"
safe_clean ~/Library/Caches/wget/* "wget cache"
safe_clean ~/Library/Caches/CocoaPods/* "CocoaPods cache"
# Package managers and dependencies
safe_clean ~/.bundle/cache/* "Ruby Bundler cache"
safe_clean ~/.composer/cache/* "PHP Composer cache"
safe_clean ~/.nuget/packages/* "NuGet packages cache"
safe_clean ~/.ivy2/cache/* "Ivy cache"
safe_clean ~/.pub-cache/* "Dart Pub cache"
# API and monitoring tools
safe_clean ~/Library/Caches/com.getpaw.Paw/* "Paw API cache"
safe_clean ~/Library/Caches/com.charlesproxy.charles/* "Charles Proxy cache"
safe_clean ~/Library/Caches/com.proxyman.NSProxy/* "Proxyman cache"
safe_clean ~/.grafana/cache/* "Grafana cache"
safe_clean ~/.prometheus/data/wal/* "Prometheus WAL cache"
# CI/CD tools
safe_clean ~/.jenkins/workspace/*/target/* "Jenkins workspace cache"
safe_clean ~/.cache/gitlab-runner/* "GitLab Runner cache"
safe_clean ~/.github/cache/* "GitHub Actions cache"
safe_clean ~/.circleci/cache/* "CircleCI cache"
end_section
# System-level cleanup function
run_system_cleanup() {
log_header "System-level deep clean"
# Request elevated privileges
request_sudo
if [[ "$SKIP_SYSTEM" != "true" ]]; then
sudo rm -rf /Library/Caches/* 2>/dev/null || true
sudo rm -rf /private/var/log/asl/* 2>/dev/null || true
sudo rm -rf /private/var/tmp/* 2>/dev/null || true
sudo rm -rf /tmp/* 2>/dev/null || true
sudo rm -rf /private/var/vm/sleepimage 2>/dev/null || true
# Refresh system caches
sudo dscacheutil -flushcache 2>/dev/null || true
sudo killall -HUP mDNSResponder 2>/dev/null || true
sudo atsutil databases -remove 2>/dev/null || true
# Font caches and system services
sudo atsutil databases -removeUser 2>/dev/null || true
sudo atsutil databases -remove 2>/dev/null || true
# Additional system logs
sudo rm -rf /var/log/install.log* 2>/dev/null || true
sudo rm -rf /var/log/system.log.* 2>/dev/null || true
sudo rm -rf /Library/Logs/DiagnosticReports/* 2>/dev/null || true
# CloudKit and iCloud cache (risky)
sudo rm -rf ~/Library/Application\ Support/CloudDocs/session/containers/* 2>/dev/null || true
sudo rm -rf ~/Library/Group\ Containers/* 2>/dev/null || true
sudo rm -rf ~/Library/WebKit/*/IDBSessionStorage/* 2>/dev/null || true
sudo rm -rf ~/Library/Caches/CloudKit/CloudKitMetadata 2>/dev/null || true
# Alibaba suite
sudo rm -rf ~/Library/Caches/com.alibaba.AliLang.osx/* 2>/dev/null || true
sudo rm -rf ~/Library/Caches/com.alibaba.alilang3.osx/* 2>/dev/null || true
sudo rm -rf ~/Library/Logs/AliLangClient/* 2>/dev/null || true
# Adobe Creative Suite (risky data)
sudo rm -rf ~/Library/Caches/com.adobe.* 2>/dev/null || true
sudo rm -rf ~/Library/Caches/com.apple.FinalCut* 2>/dev/null || true
sudo rm -rf ~/Library/Caches/com.blackmagic-design.DaVinciResolve/* 2>/dev/null || true
sudo rm -rf ~/Library/Caches/com.macpaw.CleanMyMac* 2>/dev/null || true
# Virtual machines (potentially large but risky)
sudo rm -rf ~/Library/Caches/com.parallels.* 2>/dev/null || true
sudo rm -rf ~/Library/Caches/com.vmware.fusion/* 2>/dev/null || true
# Memory cleanup
sudo purge 2>/dev/null || true
echo -e " ${GREEN}${NC} System-level cache and services cleaned"
else
echo -e " ${BLUE}${NC} System-level cleanup skipped"
fi
}
# ===== 7. System-level deep clean =====
if [[ "$SYSTEM_CLEAN" == "true" ]]; then
run_system_cleanup
fi
# iOS device backups
log_header "Checking iOS device backups..."
backup_dir="$HOME/Library/Application Support/MobileSync/Backup"
if [[ -d "$backup_dir" ]] && find "$backup_dir" -mindepth 1 -maxdepth 1 | read -r _; then
backup_kb=$(du -sk "$backup_dir" 2>/dev/null | awk '{print $1}')
if [[ -n "${backup_kb:-}" && "$backup_kb" -gt 102400 ]]; then # >100MB
backup_human=$(du -shm "$backup_dir" 2>/dev/null | awk '{print $1"M"}')
echo -e " 👉 Found ${GREEN}${backup_human}${NC}, you can delete it manually"
echo -e " 👉 ${backup_dir}"
else
echo -e " ✨ Nothing to tidy"
fi
else
echo -e " ✨ Nothing to tidy"
fi
# ===== 7. Summary =====
log_header "Cleanup summary"
space_after=$(df / | tail -1 | awk '{print $4}')
current_space_after=$(df -h / | tail -1 | awk '{print $4}')
echo "==================================================================="
space_freed_kb=$((space_after - space_before))
if [[ $space_freed_kb -gt 0 ]]; then
freed_gb=$(echo "$space_freed_kb" | awk '{printf "%.2f", $1/1024/1024}')
echo -e "🎉 User-level cleanup complete | 💾 Freed space: ${RED}${freed_gb}GB${NC}"
else
echo "🎉 User-level cleanup complete"
fi
echo "📊 Items processed: $total_items | 💾 Free space now: $current_space_after"
if [[ "$IS_M_SERIES" == "true" ]]; then
echo "✨ Apple Silicon optimizations finished"
fi
# Prompt for system-level cleanup if not already done
if [[ "$SYSTEM_CLEAN" != "true" ]]; then
echo ""
echo -e "${BLUE}💡 Want even more space?${NC}"
echo -e " Run: ${GREEN}clean --system${NC} for deep system cleanup (requires password)"
echo -e " This cleans system cache, temp files, and performs memory optimization"
fi
echo "==================================================================="