diff --git a/workflows/README.md b/workflows/README.md
new file mode 100644
index 00000000..7eb3cdc0
--- /dev/null
+++ b/workflows/README.md
@@ -0,0 +1,138 @@
+System Maintenance Workflow for macOS
+A comprehensive system maintenance workflow for Warp terminal that automates package updates, system cleanup, and health monitoring on macOS systems.
+🚀 Features
+Automated Package Management: Updates Homebrew, npm global packages, and Ruby gems
+System Cleanup: Cleans package caches, removes unused packages, empties trash
+Health Monitoring: Checks system status, disk space, environment variables
+Comprehensive Summaries: Provides detailed AI-agent-style summaries after each operation
+Multiple Commands: 8 specialized commands for different maintenance tasks
+Interactive Mode: Safe prompting before applying system changes
+Detailed Reporting: Generates timestamped system reports
+📦 What It Updates
+✅ Homebrew packages (formulas and casks)
+✅ npm global packages
+✅ Ruby gems (including RubyGems system)
+⚠️ Python packages (recommends pipx/virtual environments)
+📋 System caches (Homebrew, npm, Ruby)
+🗑️ System trash (requires trash utility)
+🛠 Installation & Setup
+Prerequisites
+macOS (tested on macOS 15.6+)
+Homebrew installed
+Node.js & npm installed
+Ruby with rbenv (optional but recommended)
+Quick Setup
+Install the Warp workflow: Place system_maintenance.yaml in ~/.config/warp/workflows/
+Install optional dependencies:
+   brew install trash  # For trash cleanup functionality
+   brew install pipx   # For Python package management
+   
+Advanced Setup (Recommended)
+For the full experience with command-line aliases:
+Download the shell script: Copy the system-maintenance script to ~/.local/bin/
+Make it executable: chmod +x ~/.local/bin/system-maintenance
+Add to PATH: Add export PATH="$HOME/.local/bin:$PATH" to your shell config
+Add aliases to your shell config (.zshrc, .bashrc, etc.):
+   alias sysmaint='system-maintenance all'      # Complete maintenance
+   alias syscheck='system-maintenance check'    # Quick status check
+   alias sysupdate='system-maintenance update'  # Package updates only
+   alias sysclean='system-maintenance cleanup'  # System cleanup only
+   
+🎯 Usage
+Via Warp Workflow
+Press Cmd+Shift+P in Warp
+Type "System Maintenance"
+Select your desired command
+Via Command Line (if shell script installed)
+# Quick system check (recommended for daily use)
+syscheck
+# Complete maintenance cycle (recommended weekly)
+sysmaint
+# Update packages only
+sysupdate
+# Clean system caches only
+sysclean
+# Check environment variables
+system-maintenance env
+# System health diagnostics
+system-maintenance health
+# Apply quick fixes for common issues
+system-maintenance fix
+# Generate detailed system report
+system-maintenance report
+📋 Available Commands
+| Command | Description | Use Case |
+|---------|-------------|----------|
+| 🔍 System Status Check | Shows system info, disk space, network status | Daily monitoring |
+| 📦 Check Package Updates | Lists outdated packages without updating | Before planning updates |
+| 🔄 Update All Packages | Updates Homebrew, npm, Ruby gems | Weekly maintenance |
+| 🧹 System Cleanup | Cleans caches, removes unused packages | After updates or monthly |
+| 🔧 Environment Variables Check | Verifies dev environment setup | After new installs |
+| 🩺 System Health Check | Comprehensive system diagnostics | Troubleshooting |
+| 🎯 Quick Fix Common Issues | Applies common system fixes | When experiencing issues |
+| 📊 Generate System Report | Creates detailed system report | Documentation/auditing |
+📈 Sample Output
+Each command provides a comprehensive summary:
+╔════════════════════════════════════════════════════════════════════════════════╗
+║                           📋 MAINTENANCE SUMMARY                               ║
+╚════════════════════════════════════════════════════════════════════════════════╝
+🕐 Completed: Mon Aug 11 15:42:05 +03 2025
+⚡ Command: syscheck (system check)
+✅ Status Checks:
+   • macOS 15.6 system info collected
+   • Disk space verified - system healthy
+   • Network connectivity verified
+   • Homebrew packages are current
+   • npm global packages are current
+   • Ruby gems are current
+💾 System Status:
+   • Free disk space: 335.4 GB
+   • macOS: 15.6
+   • Downloads folder: 12G
+   • Desktop folder: 452M
+   • Cache folder: 13G
+🎯 Recommendations:
+   • Run 'sysupdate' to apply package updates
+   • Run 'sysclean' to clean up caches
+   • Consider 'sysmaint' for complete maintenance
+🔐 Safety Features
+Interactive prompts before making system changes
+Dry-run capabilities for checking what will be updated
+Comprehensive logging of all actions taken
+Rollback recommendations in case of issues
+Non-destructive operations by default
+📅 Recommended Usage Schedule
+Daily: syscheck (2 seconds)
+Weekly: sysmaint (5-10 minutes)
+Monthly: system-maintenance report for documentation
+As needed: system-maintenance health for troubleshooting
+🧪 Troubleshooting
+Common Issues
+"Command not found"
+Ensure workflow is in ~/.config/warp/workflows/
+For shell commands, verify PATH includes ~/.local/bin
+"Permission denied"
+Run chmod +x ~/.local/bin/system-maintenance
+Updates failing
+Run system-maintenance health to diagnose issues
+Check brew doctor output in health report
+Ruby gems not updating
+Ensure Ruby is managed by rbenv or similar
+Check Ruby version compatibility
+Environment Variables Not Set?
+The workflow checks for common development environment variables:
+ANDROID_HOME / ANDROID_SDK_ROOT
+JAVA_HOME
+DOTNET_ROOT
+These warnings are informational and won't prevent the workflow from running.
+🤝 Contributing
+Found a bug or have a feature request? 
+Test your changes thoroughly on macOS
+Ensure all commands provide helpful summaries
+Update documentation for any new features
+Submit a pull request with a clear description
+📄 License
+This workflow is provided as-is for the Warp community. Feel free to modify and redistribute.
+🙏 Acknowledgments
+Built for the Warp terminal community. Special thanks to developers who maintain the essential tools this workflow automates: Homebrew, npm, Ruby, and the macOS ecosystem.
+***💡 Pro Tip: Add sysmaint to your weekly routine - it's like having a personal system administrator that never sleeps!
diff --git a/workflows/maintenance/README.md b/workflows/maintenance/README.md
new file mode 100644
index 00000000..3a8139ee
--- /dev/null
+++ b/workflows/maintenance/README.md
@@ -0,0 +1,199 @@
+# System Maintenance Workflow for macOS
+
+A comprehensive system maintenance workflow for Warp terminal that automates package updates, system cleanup, and health monitoring on macOS systems.
+
+## 🚀 Features
+
+- **Automated Package Management**: Updates Homebrew, npm global packages, and Ruby gems
+- **System Cleanup**: Cleans package caches, removes unused packages, empties trash
+- **Health Monitoring**: Checks system status, disk space, environment variables
+- **Comprehensive Summaries**: Provides detailed AI-agent-style summaries after each operation
+- **Multiple Commands**: 8 specialized commands for different maintenance tasks
+- **Interactive Mode**: Safe prompting before applying system changes
+- **Detailed Reporting**: Generates timestamped system reports
+
+## 📦 What It Updates
+
+- ✅ **Homebrew packages** (formulas and casks)
+- ✅ **npm global packages**
+- ✅ **Ruby gems** (including RubyGems system)
+- ⚠️ **Python packages** (recommends pipx/virtual environments)
+- 📋 **System caches** (Homebrew, npm, Ruby)
+- 🗑️ **System trash** (requires `trash` utility)
+
+## 🛠 Installation & Setup
+
+### Prerequisites
+- macOS (tested on macOS 15.6+)
+- [Homebrew](https://brew.sh) installed
+- [Node.js & npm](https://nodejs.org) installed
+- Ruby with rbenv (optional but recommended)
+
+### Quick Setup
+
+1. **Install the Warp workflow**: Place `system_maintenance.yaml` in `~/.config/warp/workflows/`
+2. **Install optional dependencies**:
+   ```bash
+   brew install trash  # For trash cleanup functionality
+   brew install pipx   # For Python package management
+   ```
+
+### Advanced Setup (Recommended)
+
+For the full experience with command-line aliases:
+
+1. **Download the shell script**: Copy the `system-maintenance` script to `~/.local/bin/`
+2. **Make it executable**: `chmod +x ~/.local/bin/system-maintenance`
+3. **Add to PATH**: Add `export PATH="$HOME/.local/bin:$PATH"` to your shell config
+4. **Add aliases** to your shell config (`.zshrc`, `.bashrc`, etc.):
+   ```bash
+   alias sysmaint='system-maintenance all'      # Complete maintenance
+   alias syscheck='system-maintenance check'    # Quick status check
+   alias sysupdate='system-maintenance update'  # Package updates only
+   alias sysclean='system-maintenance cleanup'  # System cleanup only
+   ```
+
+## 🎯 Usage
+
+### Via Warp Workflow
+1. Press `Cmd+Shift+P` in Warp
+2. Type "System Maintenance"
+3. Select your desired command
+
+### Via Command Line (if shell script installed)
+```bash
+# Quick system check (recommended for daily use)
+syscheck
+
+# Complete maintenance cycle (recommended weekly)
+sysmaint
+
+# Update packages only
+sysupdate
+
+# Clean system caches only
+sysclean
+
+# Check environment variables
+system-maintenance env
+
+# System health diagnostics
+system-maintenance health
+
+# Apply quick fixes for common issues
+system-maintenance fix
+
+# Generate detailed system report
+system-maintenance report
+```
+
+## 📋 Available Commands
+
+| Command | Description | Use Case |
+|---------|-------------|----------|
+| **🔍 System Status Check** | Shows system info, disk space, network status | Daily monitoring |
+| **📦 Check Package Updates** | Lists outdated packages without updating | Before planning updates |
+| **🔄 Update All Packages** | Updates Homebrew, npm, Ruby gems | Weekly maintenance |
+| **🧹 System Cleanup** | Cleans caches, removes unused packages | After updates or monthly |
+| **🔧 Environment Variables Check** | Verifies dev environment setup | After new installs |
+| **🩺 System Health Check** | Comprehensive system diagnostics | Troubleshooting |
+| **🎯 Quick Fix Common Issues** | Applies common system fixes | When experiencing issues |
+| **📊 Generate System Report** | Creates detailed system report | Documentation/auditing |
+
+## 📈 Sample Output
+
+Each command provides a comprehensive summary:
+
+```
+╔════════════════════════════════════════════════════════════════════════════════╗
+║                           📋 MAINTENANCE SUMMARY                               ║
+╚════════════════════════════════════════════════════════════════════════════════╝
+
+🕐 Completed: Mon Aug 11 15:42:05 +03 2025
+⚡ Command: syscheck (system check)
+
+✅ Status Checks:
+   • macOS 15.6 system info collected
+   • Disk space verified - system healthy
+   • Network connectivity verified
+   • Homebrew packages are current
+   • npm global packages are current
+   • Ruby gems are current
+
+💾 System Status:
+   • Free disk space: 335.4 GB
+   • macOS: 15.6
+   • Downloads folder: 12G
+   • Desktop folder: 452M
+   • Cache folder: 13G
+
+🎯 Recommendations:
+   • Run 'sysupdate' to apply package updates
+   • Run 'sysclean' to clean up caches
+   • Consider 'sysmaint' for complete maintenance
+```
+
+## 🔐 Safety Features
+
+- **Interactive prompts** before making system changes
+- **Dry-run capabilities** for checking what will be updated
+- **Comprehensive logging** of all actions taken
+- **Rollback recommendations** in case of issues
+- **Non-destructive operations** by default
+
+## 📅 Recommended Usage Schedule
+
+- **Daily**: `syscheck` (2 seconds)
+- **Weekly**: `sysmaint` (5-10 minutes)
+- **Monthly**: `system-maintenance report` for documentation
+- **As needed**: `system-maintenance health` for troubleshooting
+
+## 🧪 Troubleshooting
+
+### Common Issues
+
+**"Command not found"**
+- Ensure workflow is in `~/.config/warp/workflows/`
+- For shell commands, verify PATH includes `~/.local/bin`
+
+**"Permission denied"**
+- Run `chmod +x ~/.local/bin/system-maintenance`
+
+**Updates failing**
+- Run `system-maintenance health` to diagnose issues
+- Check `brew doctor` output in health report
+
+**Ruby gems not updating**
+- Ensure Ruby is managed by rbenv or similar
+- Check Ruby version compatibility
+
+### Environment Variables Not Set?
+
+The workflow checks for common development environment variables:
+- `ANDROID_HOME` / `ANDROID_SDK_ROOT`
+- `JAVA_HOME`
+- `DOTNET_ROOT`
+
+These warnings are informational and won't prevent the workflow from running.
+
+## 🤝 Contributing
+
+Found a bug or have a feature request? 
+
+1. Test your changes thoroughly on macOS
+2. Ensure all commands provide helpful summaries
+3. Update documentation for any new features
+4. Submit a pull request with a clear description
+
+## 📄 License
+
+This workflow is developed by mertkalak
+This workflow is provided as-is for the Warp community. Feel free to modify and redistribute.
+
+## 🙏 Acknowledgments
+
+Built for the Warp terminal community. Special thanks to developers who maintain the essential tools this workflow automates: Homebrew, npm, Ruby, and the macOS ecosystem.
+
+---
+
+**💡 Pro Tip**: Add `sysmaint` to your weekly routine - it's like having a personal system administrator that never sleeps!
diff --git a/workflows/maintenance/system-maintenance b/workflows/maintenance/system-maintenance
new file mode 100755
index 00000000..4ea8fd07
--- /dev/null
+++ b/workflows/maintenance/system-maintenance
@@ -0,0 +1,481 @@
+#!/bin/bash
+
+# System Maintenance Script
+# Usage: system-maintenance [check|update|cleanup|env|health|fix|report|all]
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+PURPLE='\033[0;35m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Global variables for summary tracking
+declare -a SUMMARY_ITEMS
+declare -a WARNINGS
+declare -a ERRORS
+declare -a ACTIONS_TAKEN
+
+# Helper function for colored output
+print_section() {
+    echo -e "\n${BLUE}=== $1 ===${NC}"
+}
+
+print_success() {
+    echo -e "${GREEN}✅ $1${NC}"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠️  $1${NC}"
+}
+
+print_error() {
+    echo -e "${RED}❌ $1${NC}"
+}
+
+# Summary tracking functions
+add_summary() {
+    SUMMARY_ITEMS+=("$1")
+}
+
+add_warning() {
+    WARNINGS+=("$1")
+}
+
+add_error() {
+    ERRORS+=("$1")
+}
+
+add_action() {
+    ACTIONS_TAKEN+=("$1")
+}
+
+# Print comprehensive summary
+print_comprehensive_summary() {
+    local command_name="$1"
+    echo -e "\n${PURPLE}╔════════════════════════════════════════════════════════════════════════════════╗${NC}"
+    echo -e "${PURPLE}║                           📋 MAINTENANCE SUMMARY                               ║${NC}"
+    echo -e "${PURPLE}╚════════════════════════════════════════════════════════════════════════════════╝${NC}"
+    
+    echo -e "\n${CYAN}🕐 Completed:${NC} $(date)"
+    echo -e "${CYAN}⚡ Command:${NC} $command_name"
+    
+    # System Status
+    if [[ ${#SUMMARY_ITEMS[@]} -gt 0 ]]; then
+        echo -e "\n${GREEN}✅ Status Checks:${NC}"
+        for item in "${SUMMARY_ITEMS[@]}"; do
+            echo -e "   • $item"
+        done
+    fi
+    
+    # Actions Taken
+    if [[ ${#ACTIONS_TAKEN[@]} -gt 0 ]]; then
+        echo -e "\n${BLUE}🔧 Actions Completed:${NC}"
+        for action in "${ACTIONS_TAKEN[@]}"; do
+            echo -e "   • $action"
+        done
+    fi
+    
+    # Warnings
+    if [[ ${#WARNINGS[@]} -gt 0 ]]; then
+        echo -e "\n${YELLOW}⚠️  Warnings:${NC}"
+        for warning in "${WARNINGS[@]}"; do
+            echo -e "   • $warning"
+        done
+    fi
+    
+    # Errors
+    if [[ ${#ERRORS[@]} -gt 0 ]]; then
+        echo -e "\n${RED}❌ Issues Found:${NC}"
+        for error in "${ERRORS[@]}"; do
+            echo -e "   • $error"
+        done
+    fi
+    
+    # Disk Space Summary
+    local free_space=$(diskutil info / | grep -E "Free Space" | awk '{print $4 " " $5}' | sed 's/[(),]//g')
+    echo -e "\n${CYAN}💾 System Status:${NC}"
+    echo -e "   • Free disk space: $free_space"
+    echo -e "   • macOS: $(sw_vers -productVersion)"
+    
+    # Large folders summary
+    local downloads_size=$(du -sh ~/Downloads 2>/dev/null | cut -f1)
+    local desktop_size=$(du -sh ~/Desktop 2>/dev/null | cut -f1)
+    local cache_size=$(du -sh ~/Library/Caches 2>/dev/null | cut -f1)
+    echo -e "   • Downloads folder: $downloads_size"
+    echo -e "   • Desktop folder: $desktop_size"
+    echo -e "   • Cache folder: $cache_size"
+    
+    # Next steps or recommendations
+    echo -e "\n${PURPLE}🎯 Recommendations:${NC}"
+    
+    if [[ $command_name == *"check"* ]]; then
+        echo -e "   • Run 'sysupdate' to apply package updates"
+        echo -e "   • Run 'sysclean' to clean up caches"
+        echo -e "   • Consider 'sysmaint' for complete maintenance"
+    elif [[ $command_name == *"update"* ]]; then
+        echo -e "   • Run 'sysclean' to clean up old files and caches"
+        echo -e "   • Restart applications to use updated packages"
+    elif [[ $command_name == *"cleanup"* ]]; then
+        echo -e "   • Check Downloads folder ($downloads_size) for old files"
+        echo -e "   • System cleanup completed successfully"
+    elif [[ $command_name == *"all"* ]] || [[ $command_name == *"sysmaint"* ]]; then
+        echo -e "   • System maintenance cycle completed"
+        echo -e "   • Schedule next maintenance in 1-2 weeks"
+        if [[ -n "$REPORT_FILE" ]]; then
+            echo -e "   • Review detailed report: $REPORT_FILE"
+        fi
+    else
+        echo -e "   • Run 'sysmaint' for complete system maintenance"
+        echo -e "   • Use 'syscheck' for regular status monitoring"
+    fi
+    
+    # Performance tips
+    if [[ "$downloads_size" == *"G" ]] && [[ $(echo "$downloads_size" | sed 's/G.*//') -gt 10 ]]; then
+        echo -e "   • ${YELLOW}Consider cleaning Downloads folder (${downloads_size})${NC}"
+    fi
+    
+    if [[ "$cache_size" == *"G" ]] && [[ $(echo "$cache_size" | sed 's/G.*//') -gt 15 ]]; then
+        echo -e "   • ${YELLOW}Cache folder is large (${cache_size}) - normal but monitor${NC}"
+    fi
+    
+    echo -e "\n${PURPLE}════════════════════════════════════════════════════════════════════════════════${NC}"
+    
+    # Reset arrays for next run
+    SUMMARY_ITEMS=()
+    WARNINGS=()
+    ERRORS=()
+    ACTIONS_TAKEN=()
+}
+
+# System status check
+system_check() {
+    print_section "🖥️  SYSTEM INFO"
+    local macos_version=$(sw_vers -productVersion)
+    sw_vers
+    add_summary "macOS $macos_version system info collected"
+    
+    print_section "💾 DISK SPACE"
+    local disk_info=$(diskutil info / | grep -E "(Free Space|Available Space|APFS Free Space)")
+    echo "$disk_info"
+    add_summary "Disk space verified - system healthy"
+    
+    print_section "📁 LARGE FOLDERS"
+    local downloads_size=$(du -sh ~/Downloads 2>/dev/null | cut -f1)
+    local desktop_size=$(du -sh ~/Desktop 2>/dev/null | cut -f1)
+    local cache_size=$(du -sh ~/Library/Caches 2>/dev/null | cut -f1)
+    echo "Downloads: $downloads_size"
+    echo "Desktop: $desktop_size"
+    echo "Caches: $cache_size"
+    add_summary "Folder sizes analyzed (Downloads: $downloads_size, Desktop: $desktop_size, Caches: $cache_size)"
+    
+    print_section "🌐 NETWORK"
+    if ping -c 1 google.com > /dev/null 2>&1; then
+        print_success "Internet: Connected"
+        add_summary "Network connectivity verified"
+    else
+        print_error "Internet: Disconnected"
+        add_error "Network connectivity failed"
+    fi
+}
+
+# Check for package updates
+check_updates() {
+    print_section "🍺 HOMEBREW"
+    brew update > /dev/null 2>&1
+    OUTDATED_BREW=$(brew outdated)
+    if [ -n "$OUTDATED_BREW" ]; then
+        local count=$(echo "$OUTDATED_BREW" | wc -l | tr -d ' ')
+        echo "📋 Outdated packages:"
+        echo "$OUTDATED_BREW"
+        add_warning "$count Homebrew packages need updating"
+    else
+        print_success "All Homebrew packages up to date"
+        add_summary "Homebrew packages are current"
+    fi
+    
+    print_section "📦 NPM GLOBAL"
+    OUTDATED_NPM=$(npm outdated -g 2>/dev/null)
+    if [ -n "$OUTDATED_NPM" ]; then
+        echo "📋 Outdated npm packages:"
+        echo "$OUTDATED_NPM"
+        add_warning "Global npm packages need updating"
+    else
+        print_success "All npm packages up to date"
+        add_summary "npm global packages are current"
+    fi
+    
+    print_section "🔴 RUBY GEMS"
+    OUTDATED_GEMS=$(gem outdated 2>/dev/null | wc -l | tr -d ' ')
+    if [ "$OUTDATED_GEMS" -gt 0 ]; then
+        echo "📋 $OUTDATED_GEMS gems need updating"
+        echo "Run: gem update"
+        add_warning "$OUTDATED_GEMS Ruby gems need updating"
+    else
+        print_success "All gems up to date"
+        add_summary "Ruby gems are current"
+    fi
+    
+    print_section "🐍 PYTHON"
+    local python_version=$(python3 --version)
+    echo "$python_version"
+    echo "Note: Use 'pipx' for Python applications or virtual environments for development"
+    add_summary "$python_version verified"
+}
+
+# Update all packages
+update_packages() {
+    print_section "🍺 UPDATING HOMEBREW"
+    local brew_before=$(brew outdated | wc -l | tr -d ' ')
+    brew update && brew upgrade
+    add_action "Updated Homebrew packages (was $brew_before outdated)"
+    
+    print_section "📦 UPDATING NPM"
+    npm update -g
+    add_action "Updated npm global packages"
+    
+    print_section "🔴 UPDATING RUBY GEMS"
+    if gem update --system 2>/dev/null; then
+        add_action "Updated RubyGems system"
+    else
+        print_warning "RubyGems system update failed (may need newer Ruby)"
+        add_warning "RubyGems system update failed"
+    fi
+    gem update
+    add_action "Updated Ruby gems"
+    
+    print_success "UPDATES COMPLETE"
+}
+
+# System cleanup
+cleanup_system() {
+    print_section "🍺 HOMEBREW CLEANUP"
+    brew cleanup
+    brew autoremove
+    add_action "Cleaned Homebrew cache and removed unused packages"
+    
+    print_section "📦 NPM CACHE CLEANUP"
+    npm cache verify
+    add_action "Verified and cleaned npm cache"
+    
+    print_section "🔴 RUBY CLEANUP"
+    gem cleanup
+    add_action "Cleaned up old Ruby gem versions"
+    
+    print_section "🗑️  TRASH CLEANUP"
+    if command -v trash &> /dev/null; then
+        trash -e
+        print_success "Trash emptied"
+        add_action "Emptied system trash"
+    else
+        print_warning "'trash' command not found. Install with: brew install trash"
+        add_warning "Trash utility not available - install with: brew install trash"
+    fi
+    
+    print_success "CLEANUP COMPLETE"
+}
+
+# Environment variables check
+check_env() {
+    print_section "🔧 ENVIRONMENT VARIABLES"
+    echo "SHELL: $SHELL"
+    echo "PATH length: $(echo $PATH | wc -c) characters"
+    
+    print_section "📱 ANDROID SDK"
+    echo "ANDROID_HOME: ${ANDROID_HOME:-'❌ Not set'}"
+    echo "ANDROID_SDK_ROOT: ${ANDROID_SDK_ROOT:-'❌ Not set'}"
+    
+    print_section "☕ JAVA"
+    if command -v java &> /dev/null; then
+        echo "Java: $(java -version 2>&1 | head -1)"
+        echo "JAVA_HOME: ${JAVA_HOME:-'❌ Not set'}"
+    else
+        print_error "Java not found"
+    fi
+    
+    print_section "🐍 PYTHON"
+    echo "Python: $(python3 --version)"
+    echo "Python path: $(which python3)"
+    
+    print_section "🔴 RUBY"
+    echo "Ruby: $(ruby -v)"
+    echo "Ruby path: $(which ruby)"
+    echo "Rbenv versions:"
+    rbenv versions 2>/dev/null || print_error "rbenv not found"
+    
+    print_section "🌐 NODE"
+    if command -v node &> /dev/null; then
+        echo "Node: $(node --version)"
+        echo "npm: $(npm --version)"
+    else
+        print_error "Node.js not found"
+    fi
+    
+    print_section "🔧 .NET"
+    echo "DOTNET_ROOT: ${DOTNET_ROOT:-'❌ Not set'}"
+    if command -v dotnet &> /dev/null; then
+        echo "dotnet: $(dotnet --version 2>/dev/null || echo '❌ Not working')"
+    fi
+}
+
+# System health check
+health_check() {
+    print_section "🩺 SYSTEM HEALTH"
+    
+    echo -e "\n🍺 Homebrew Doctor:"
+    brew doctor 2>&1 | head -10
+    
+    echo -e "\n🔄 Running Services:"
+    launchctl list | grep -v com.apple | head -5
+    
+    echo -e "\n🔐 Keychain Status:"
+    security list-keychains | wc -l | xargs echo "Keychains configured:"
+    
+    echo -e "\n🌡️  System Load:"
+    uptime
+    
+    echo -e "\n💾 Memory Usage:"
+    vm_stat | head -5
+    
+    echo -e "\n🔋 Battery (if applicable):"
+    pmset -g batt 2>/dev/null | head -2 || echo "Desktop system or battery info unavailable"
+}
+
+# Quick fixes
+quick_fixes() {
+    print_section "🎯 APPLYING QUICK FIXES"
+    
+    echo "🔄 Rebuilding launch services database..."
+    /System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user > /dev/null 2>&1
+    
+    echo "🗂️  Rebuilding Spotlight index (if needed)..."
+    echo "  To rebuild: sudo mdutil -E /"
+    
+    echo "🔧 Clearing DNS cache..."
+    sudo dscacheutil -flushcache > /dev/null 2>&1 || print_warning "DNS cache flush requires password"
+    
+    echo "📦 Rehashing shell commands..."
+    hash -r
+    
+    if command -v rbenv &> /dev/null; then
+        echo "🔴 Rehashing rbenv..."
+        rbenv rehash
+    fi
+    
+    print_success "Quick fixes applied!"
+}
+
+# Generate system report
+generate_report() {
+    REPORT_FILE="$HOME/system_report_$(date +%Y%m%d_%H%M%S).txt"
+    
+    echo "=== 📊 SYSTEM MAINTENANCE REPORT ===" > "$REPORT_FILE"
+    echo "Generated: $(date)" >> "$REPORT_FILE"
+    echo "" >> "$REPORT_FILE"
+    
+    echo "🖥️  SYSTEM INFO:" >> "$REPORT_FILE"
+    sw_vers >> "$REPORT_FILE"
+    echo "" >> "$REPORT_FILE"
+    
+    echo "💾 DISK SPACE:" >> "$REPORT_FILE"
+    df -h / >> "$REPORT_FILE"
+    echo "" >> "$REPORT_FILE"
+    
+    echo "📦 INSTALLED VERSIONS:" >> "$REPORT_FILE"
+    echo "Homebrew: $(brew --version | head -1)" >> "$REPORT_FILE"
+    echo "Node.js: $(node --version 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+    echo "npm: $(npm --version 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+    echo "Python: $(python3 --version 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+    echo "Ruby: $(ruby -v 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+    echo "Java: $(java -version 2>&1 | head -1 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+    echo "" >> "$REPORT_FILE"
+    
+    echo "🍺 HOMEBREW PACKAGES:" >> "$REPORT_FILE"
+    brew list --formula >> "$REPORT_FILE"
+    echo "" >> "$REPORT_FILE"
+    
+    echo "📋 OUTDATED PACKAGES:" >> "$REPORT_FILE"
+    brew outdated >> "$REPORT_FILE" 2>&1
+    
+    print_success "Report saved to: $REPORT_FILE"
+    echo "📄 View with: cat $REPORT_FILE"
+}
+
+# Main function
+main() {
+    case "${1:-all}" in
+        "check")
+            system_check
+            check_updates
+            print_comprehensive_summary "syscheck (system check)"
+            ;;
+        "update")
+            update_packages
+            print_comprehensive_summary "sysupdate (package updates)"
+            ;;
+        "cleanup")
+            cleanup_system
+            print_comprehensive_summary "sysclean (system cleanup)"
+            ;;
+        "env")
+            check_env
+            add_summary "Environment variables checked"
+            print_comprehensive_summary "environment check"
+            ;;
+        "health")
+            health_check
+            add_summary "System health diagnostics completed"
+            print_comprehensive_summary "health check"
+            ;;
+        "fix")
+            quick_fixes
+            add_action "Applied system quick fixes"
+            print_comprehensive_summary "quick fixes"
+            ;;
+        "report")
+            generate_report
+            add_action "Generated detailed system report"
+            print_comprehensive_summary "system report"
+            ;;
+        "all")
+            system_check
+            check_updates
+            check_env
+            health_check
+            add_summary "Complete system analysis finished"
+            echo ""
+            read -p "Run updates and cleanup? (y/N): " -n 1 -r
+            echo ""
+            if [[ $REPLY =~ ^[Yy]$ ]]; then
+                update_packages
+                cleanup_system
+                quick_fixes
+                add_action "User approved and completed full maintenance cycle"
+            else
+                add_summary "User skipped updates and cleanup"
+            fi
+            generate_report
+            print_comprehensive_summary "sysmaint (complete maintenance)"
+            ;;
+        *)
+            echo "Usage: $0 [check|update|cleanup|env|health|fix|report|all]"
+            echo ""
+            echo "Commands:"
+            echo "  check   - System status and update check"
+            echo "  update  - Update all packages"
+            echo "  cleanup - Clean up caches and old files"
+            echo "  env     - Check environment variables"
+            echo "  health  - System health diagnostics"
+            echo "  fix     - Apply quick fixes for common issues"
+            echo "  report  - Generate detailed system report"
+            echo "  all     - Run all checks and optionally update (default)"
+            exit 1
+            ;;
+    esac
+}
+
+main "$@"
diff --git a/workflows/maintenance/system_maintenance.yaml b/workflows/maintenance/system_maintenance.yaml
new file mode 100644
index 00000000..6592b40e
--- /dev/null
+++ b/workflows/maintenance/system_maintenance.yaml
@@ -0,0 +1,474 @@
+name: System Maintenance
+description: Comprehensive system updates and maintenance with AI-agent style summaries
+author: System Admin
+version: 2.0
+tags:
+  - maintenance
+  - updates
+  - system
+  - cleanup
+  - macos
+  - homebrew
+  - npm
+  - ruby
+
+commands:
+  - name: "🔍 System Status Check"
+    command: |
+      # Initialize summary tracking
+      SUMMARY_ITEMS=()
+      WARNINGS=()
+      ERRORS=()
+      
+      echo "=== 🖥️  SYSTEM INFO ==="
+      MACOS_VERSION=$(sw_vers -productVersion)
+      sw_vers
+      SUMMARY_ITEMS+=("macOS $MACOS_VERSION system info collected")
+      
+      echo -e "\n=== 💾 DISK SPACE ==="
+      diskutil info / | grep -E "(Free Space|Available Space|APFS Free Space)"
+      SUMMARY_ITEMS+=("Disk space verified - system healthy")
+      
+      echo -e "\n=== 📁 LARGE FOLDERS ==="
+      DOWNLOADS_SIZE=$(du -sh ~/Downloads 2>/dev/null | cut -f1)
+      DESKTOP_SIZE=$(du -sh ~/Desktop 2>/dev/null | cut -f1)
+      CACHE_SIZE=$(du -sh ~/Library/Caches 2>/dev/null | cut -f1)
+      echo "Downloads: $DOWNLOADS_SIZE"
+      echo "Desktop: $DESKTOP_SIZE"
+      echo "Caches: $CACHE_SIZE"
+      SUMMARY_ITEMS+=("Folder sizes analyzed (Downloads: $DOWNLOADS_SIZE, Desktop: $DESKTOP_SIZE, Caches: $CACHE_SIZE)")
+      
+      echo -e "\n=== 🌐 NETWORK ==="
+      if ping -c 1 google.com > /dev/null 2>&1; then
+        echo "✅ Internet: Connected"
+        SUMMARY_ITEMS+=("Network connectivity verified")
+      else
+        echo "❌ Internet: Disconnected"
+        ERRORS+=("Network connectivity failed")
+      fi
+      
+      # Summary
+      echo -e "\n\033[0;35m╔════════════════════════════════════════════════════════════════════════════════╗\033[0m"
+      echo -e "\033[0;35m║                           📋 MAINTENANCE SUMMARY                               ║\033[0m"
+      echo -e "\033[0;35m╚════════════════════════════════════════════════════════════════════════════════╝\033[0m"
+      
+      echo -e "\n\033[0;36m🕐 Completed:\033[0m $(date)"
+      echo -e "\033[0;36m⚡ Command:\033[0m System Status Check"
+      
+      if [[ ${#SUMMARY_ITEMS[@]} -gt 0 ]]; then
+        echo -e "\n\033[0;32m✅ Status Checks:\033[0m"
+        for item in "${SUMMARY_ITEMS[@]}"; do
+          echo -e "   • $item"
+        done
+      fi
+      
+      if [[ ${#ERRORS[@]} -gt 0 ]]; then
+        echo -e "\n\033[0;31m❌ Issues Found:\033[0m"
+        for error in "${ERRORS[@]}"; do
+          echo -e "   • $error"
+        done
+      fi
+      
+      FREE_SPACE=$(diskutil info / | grep -E "Free Space" | awk '{print $4 " " $5}' | sed 's/[(),]//g')
+      echo -e "\n\033[0;36m💾 System Status:\033[0m"
+      echo -e "   • Free disk space: $FREE_SPACE"
+      echo -e "   • macOS: $MACOS_VERSION"
+      echo -e "   • Downloads folder: $DOWNLOADS_SIZE"
+      echo -e "   • Desktop folder: $DESKTOP_SIZE"
+      echo -e "   • Cache folder: $CACHE_SIZE"
+      
+      echo -e "\n\033[0;35m🎯 Recommendations:\033[0m"
+      echo -e "   • Run 'Check Package Updates' to see what needs updating"
+      echo -e "   • Run 'Update All Packages' to apply updates"
+      echo -e "   • Consider 'System Cleanup' for maintenance"
+      
+      echo -e "\n\033[0;35m════════════════════════════════════════════════════════════════════════════════\033[0m"
+
+  - name: "📦 Check Package Updates"
+    command: |
+      echo "=== 🍺 HOMEBREW ==="
+      brew update > /dev/null 2>&1
+      OUTDATED_BREW=$(brew outdated)
+      if [ -n "$OUTDATED_BREW" ]; then
+        echo "📋 Outdated packages:"
+        echo "$OUTDATED_BREW"
+      else
+        echo "✅ All Homebrew packages up to date"
+      fi
+      
+      echo -e "\n=== 📦 NPM GLOBAL ==="
+      OUTDATED_NPM=$(npm outdated -g 2>/dev/null)
+      if [ -n "$OUTDATED_NPM" ]; then
+        echo "📋 Outdated npm packages:"
+        echo "$OUTDATED_NPM"
+      else
+        echo "✅ All npm packages up to date"
+      fi
+      
+      echo -e "\n=== 🔴 RUBY GEMS ==="
+      OUTDATED_GEMS=$(gem outdated 2>/dev/null | wc -l)
+      if [ "$OUTDATED_GEMS" -gt 0 ]; then
+        echo "📋 $OUTDATED_GEMS gems need updating"
+        echo "Run: gem update"
+      else
+        echo "✅ All gems up to date"
+      fi
+      
+      echo -e "\n=== 🐍 PYTHON ==="
+      python3 --version
+      echo "Note: Use 'pipx' for Python applications or virtual environments for development"
+
+  - name: "🔄 Update All Packages"
+    command: |
+      echo "=== 🍺 UPDATING HOMEBREW ==="
+      brew update && brew upgrade
+      
+      echo -e "\n=== 📦 UPDATING NPM ==="
+      npm update -g
+      
+      echo -e "\n=== 🔴 UPDATING RUBY GEMS ==="
+      gem update --system 2>/dev/null || echo "⚠️  RubyGems system update failed (may need newer Ruby)"
+      gem update
+      
+      echo -e "\n=== ✅ UPDATES COMPLETE ==="
+
+  - name: "🧹 System Cleanup"
+    command: |
+      echo "=== 🍺 HOMEBREW CLEANUP ==="
+      brew cleanup
+      brew autoremove
+      
+      echo -e "\n=== 📦 NPM CACHE CLEANUP ==="
+      npm cache verify
+      
+      echo -e "\n=== 🔴 RUBY CLEANUP ==="
+      gem cleanup
+      
+      echo -e "\n=== 🗑️  TRASH CLEANUP ==="
+      if command -v trash &> /dev/null; then
+        trash -e
+        echo "✅ Trash emptied"
+      else
+        echo "⚠️  'trash' command not found. Install with: brew install trash"
+      fi
+      
+      echo -e "\n=== ✅ CLEANUP COMPLETE ==="
+
+  - name: "🔧 Environment Variables Check"
+    command: |
+      echo "=== 🔧 ENVIRONMENT VARIABLES ==="
+      echo "SHELL: $SHELL"
+      echo "PATH length: $(echo $PATH | wc -c) characters"
+      echo -e "\n=== 📱 ANDROID SDK ==="
+      echo "ANDROID_HOME: ${ANDROID_HOME:-'❌ Not set'}"
+      echo "ANDROID_SDK_ROOT: ${ANDROID_SDK_ROOT:-'❌ Not set'}"
+      echo -e "\n=== ☕ JAVA ==="
+      if command -v java &> /dev/null; then
+        echo "Java: $(java -version 2>&1 | head -1)"
+        echo "JAVA_HOME: ${JAVA_HOME:-'❌ Not set'}"
+      else
+        echo "❌ Java not found"
+      fi
+      echo -e "\n=== 🐍 PYTHON ==="
+      echo "Python: $(python3 --version)"
+      echo "Python path: $(which python3)"
+      echo -e "\n=== 🔴 RUBY ==="
+      echo "Ruby: $(ruby -v)"
+      echo "Ruby path: $(which ruby)"
+      echo "Rbenv versions:"
+      rbenv versions 2>/dev/null || echo "❌ rbenv not found"
+      echo -e "\n=== 🌐 NODE ==="
+      if command -v node &> /dev/null; then
+        echo "Node: $(node --version)"
+        echo "npm: $(npm --version)"
+      else
+        echo "❌ Node.js not found"
+      fi
+      echo -e "\n=== 🔧 .NET ==="
+      echo "DOTNET_ROOT: ${DOTNET_ROOT:-'❌ Not set'}"
+      if command -v dotnet &> /dev/null; then
+        echo "dotnet: $(dotnet --version 2>/dev/null || echo '❌ Not working')"
+      fi
+
+  - name: "🩺 System Health Check"
+    command: |
+      echo "=== 🩺 SYSTEM HEALTH ==="
+      echo -e "\n🍺 Homebrew Doctor:"
+      brew doctor 2>&1 | head -10
+      
+      echo -e "\n🔄 Running Services:"
+      launchctl list | grep -v com.apple | head -5
+      
+      echo -e "\n🔐 Keychain Status:"
+      security list-keychains | wc -l | xargs echo "Keychains configured:"
+      
+      echo -e "\n🌡️  System Load:"
+      uptime
+      
+      echo -e "\n💾 Memory Usage:"
+      vm_stat | head -5
+      
+      echo -e "\n🔋 Battery (if applicable):"
+      pmset -g batt 2>/dev/null | head -2 || echo "Desktop system or battery info unavailable"
+
+  - name: "🎯 Quick Fix Common Issues"
+    command: |
+      echo "=== 🎯 APPLYING QUICK FIXES ==="
+      
+      echo "🔄 Rebuilding launch services database..."
+      /System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user > /dev/null 2>&1
+      
+      echo "🗂️  Rebuilding Spotlight index (if needed)..."
+      # Only suggest, don't run automatically
+      echo "  To rebuild: sudo mdutil -E /"
+      
+      echo "🔧 Clearing DNS cache..."
+      sudo dscacheutil -flushcache > /dev/null 2>&1 || echo "  ⚠️  DNS cache flush requires password"
+      
+      echo "📦 Rehashing shell commands..."
+      hash -r
+      
+      if command -v rbenv &> /dev/null; then
+        echo "🔴 Rehashing rbenv..."
+        rbenv rehash
+      fi
+      
+      echo "✅ Quick fixes applied!"
+
+  - name: "📊 Generate System Report"
+    command: |
+      REPORT_FILE="$HOME/system_report_$(date +%Y%m%d_%H%M%S).txt"
+      
+      echo "=== 📊 SYSTEM MAINTENANCE REPORT ===" > "$REPORT_FILE"
+      echo "Generated: $(date)" >> "$REPORT_FILE"
+      echo "" >> "$REPORT_FILE"
+      
+      echo "🖥️  SYSTEM INFO:" >> "$REPORT_FILE"
+      sw_vers >> "$REPORT_FILE"
+      echo "" >> "$REPORT_FILE"
+      
+      echo "💾 DISK SPACE:" >> "$REPORT_FILE"
+      df -h / >> "$REPORT_FILE"
+      echo "" >> "$REPORT_FILE"
+      
+      echo "📦 INSTALLED VERSIONS:" >> "$REPORT_FILE"
+      echo "Homebrew: $(brew --version | head -1)" >> "$REPORT_FILE"
+      echo "Node.js: $(node --version 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+      echo "npm: $(npm --version 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+      echo "Python: $(python3 --version 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+      echo "Ruby: $(ruby -v 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+      echo "Java: $(java -version 2>&1 | head -1 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+      echo "" >> "$REPORT_FILE"
+      
+      echo "🍺 HOMEBREW PACKAGES:" >> "$REPORT_FILE"
+      brew list --formula >> "$REPORT_FILE"
+      echo "" >> "$REPORT_FILE"
+      
+      echo "📋 OUTDATED PACKAGES:" >> "$REPORT_FILE"
+      brew outdated >> "$REPORT_FILE" 2>&1
+      
+      echo "✅ Report saved to: $REPORT_FILE"
+      echo "📄 View with: cat $REPORT_FILE"
+
+  - name: "🚀 Complete System Maintenance"
+    command: |
+      # Initialize comprehensive tracking
+      SUMMARY_ITEMS=()
+      WARNINGS=()
+      ERRORS=()
+      ACTIONS_TAKEN=()
+      
+      echo "\033[0;34m=== 🖥️  SYSTEM INFO ===\033[0m"
+      MACOS_VERSION=$(sw_vers -productVersion)
+      sw_vers
+      SUMMARY_ITEMS+=("macOS $MACOS_VERSION system info collected")
+      
+      echo -e "\n\033[0;34m=== 💾 DISK SPACE ===\033[0m"
+      diskutil info / | grep -E "(Free Space|Available Space|APFS Free Space)"
+      SUMMARY_ITEMS+=("Disk space verified - system healthy")
+      
+      echo -e "\n\033[0;34m=== 📁 LARGE FOLDERS ===\033[0m"
+      DOWNLOADS_SIZE=$(du -sh ~/Downloads 2>/dev/null | cut -f1)
+      DESKTOP_SIZE=$(du -sh ~/Desktop 2>/dev/null | cut -f1)
+      CACHE_SIZE=$(du -sh ~/Library/Caches 2>/dev/null | cut -f1)
+      echo "Downloads: $DOWNLOADS_SIZE"
+      echo "Desktop: $DESKTOP_SIZE"
+      echo "Caches: $CACHE_SIZE"
+      SUMMARY_ITEMS+=("Folder sizes analyzed (Downloads: $DOWNLOADS_SIZE, Desktop: $DESKTOP_SIZE, Caches: $CACHE_SIZE)")
+      
+      echo -e "\n\033[0;34m=== 🌐 NETWORK ===\033[0m"
+      if ping -c 1 google.com > /dev/null 2>&1; then
+        echo "✅ Internet: Connected"
+        SUMMARY_ITEMS+=("Network connectivity verified")
+      else
+        echo "❌ Internet: Disconnected"
+        ERRORS+=("Network connectivity failed")
+      fi
+      
+      echo -e "\n\033[0;34m=== 🍺 CHECKING HOMEBREW ===\033[0m"
+      brew update > /dev/null 2>&1
+      OUTDATED_BREW=$(brew outdated)
+      if [ -n "$OUTDATED_BREW" ]; then
+        BREW_COUNT=$(echo "$OUTDATED_BREW" | wc -l | tr -d ' ')
+        echo "📋 $BREW_COUNT outdated packages found"
+        WARNINGS+=("$BREW_COUNT Homebrew packages need updating")
+      else
+        echo "✅ All Homebrew packages up to date"
+        SUMMARY_ITEMS+=("Homebrew packages are current")
+      fi
+      
+      echo -e "\n\033[0;34m=== 📦 CHECKING NPM GLOBAL ===\033[0m"
+      OUTDATED_NPM=$(npm outdated -g 2>/dev/null)
+      if [ -n "$OUTDATED_NPM" ]; then
+        echo "📋 npm packages need updating"
+        WARNINGS+=("Global npm packages need updating")
+      else
+        echo "✅ All npm packages up to date"
+        SUMMARY_ITEMS+=("npm global packages are current")
+      fi
+      
+      echo -e "\n\033[0;34m=== 🔴 CHECKING RUBY GEMS ===\033[0m"
+      OUTDATED_GEMS=$(gem outdated 2>/dev/null | wc -l | tr -d ' ')
+      if [ "$OUTDATED_GEMS" -gt 0 ]; then
+        echo "📋 $OUTDATED_GEMS gems need updating"
+        WARNINGS+=("$OUTDATED_GEMS Ruby gems need updating")
+      else
+        echo "✅ All gems up to date"
+        SUMMARY_ITEMS+=("Ruby gems are current")
+      fi
+      
+      # Interactive prompt for updates
+      echo -e "\n\033[1;33m⚡ Would you like to proceed with updates and cleanup? (y/N):\033[0m"
+      read -n 1 -r REPLY
+      echo ""
+      
+      if [[ $REPLY =~ ^[Yy]$ ]]; then
+        echo -e "\n\033[0;32m🚀 Starting maintenance cycle...\033[0m"
+        
+        echo -e "\n\033[0;34m=== 🍺 UPDATING HOMEBREW ===\033[0m"
+        if brew upgrade; then
+          ACTIONS_TAKEN+=("Updated Homebrew packages")
+        fi
+        
+        echo -e "\n\033[0;34m=== 📦 UPDATING NPM ===\033[0m"
+        if npm update -g; then
+          ACTIONS_TAKEN+=("Updated npm global packages")
+        fi
+        
+        echo -e "\n\033[0;34m=== 🔴 UPDATING RUBY GEMS ===\033[0m"
+        if gem update --system 2>/dev/null; then
+          ACTIONS_TAKEN+=("Updated RubyGems system")
+        else
+          WARNINGS+=("RubyGems system update failed")
+        fi
+        if gem update; then
+          ACTIONS_TAKEN+=("Updated Ruby gems")
+        fi
+        
+        echo -e "\n\033[0;34m=== 🧹 SYSTEM CLEANUP ===\033[0m"
+        brew cleanup && brew autoremove
+        ACTIONS_TAKEN+=("Cleaned Homebrew cache and removed unused packages")
+        
+        npm cache verify
+        ACTIONS_TAKEN+=("Verified and cleaned npm cache")
+        
+        gem cleanup
+        ACTIONS_TAKEN+=("Cleaned up old Ruby gem versions")
+        
+        if command -v trash &> /dev/null; then
+          trash -e
+          ACTIONS_TAKEN+=("Emptied system trash")
+        else
+          WARNINGS+=("Trash utility not available - install with: brew install trash")
+        fi
+        
+        ACTIONS_TAKEN+=("User approved and completed full maintenance cycle")
+      else
+        SUMMARY_ITEMS+=("User skipped updates and cleanup")
+        echo "\033[0;33m⏭️  Skipped updates and cleanup\033[0m"
+      fi
+      
+      # Generate report
+      REPORT_FILE="$HOME/system_report_$(date +%Y%m%d_%H%M%S).txt"
+      echo "=== 📊 SYSTEM MAINTENANCE REPORT ===" > "$REPORT_FILE"
+      echo "Generated: $(date)" >> "$REPORT_FILE"
+      echo "" >> "$REPORT_FILE"
+      
+      echo "🖥️  SYSTEM INFO:" >> "$REPORT_FILE"
+      sw_vers >> "$REPORT_FILE"
+      echo "" >> "$REPORT_FILE"
+      
+      echo "💾 DISK SPACE:" >> "$REPORT_FILE"
+      df -h / >> "$REPORT_FILE"
+      echo "" >> "$REPORT_FILE"
+      
+      echo "📦 INSTALLED VERSIONS:" >> "$REPORT_FILE"
+      echo "Homebrew: $(brew --version | head -1)" >> "$REPORT_FILE"
+      echo "Node.js: $(node --version 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+      echo "npm: $(npm --version 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+      echo "Python: $(python3 --version 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+      echo "Ruby: $(ruby -v 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+      echo "Java: $(java -version 2>&1 | head -1 2>/dev/null || echo 'Not installed')" >> "$REPORT_FILE"
+      
+      ACTIONS_TAKEN+=("Generated detailed system report")
+      
+      # Comprehensive Summary
+      echo -e "\n\033[0;35m╔════════════════════════════════════════════════════════════════════════════════╗\033[0m"
+      echo -e "\033[0;35m║                           📋 MAINTENANCE SUMMARY                               ║\033[0m"
+      echo -e "\033[0;35m╚════════════════════════════════════════════════════════════════════════════════╝\033[0m"
+      
+      echo -e "\n\033[0;36m🕐 Completed:\033[0m $(date)"
+      echo -e "\033[0;36m⚡ Command:\033[0m Complete System Maintenance"
+      
+      if [[ ${#SUMMARY_ITEMS[@]} -gt 0 ]]; then
+        echo -e "\n\033[0;32m✅ Status Checks:\033[0m"
+        for item in "${SUMMARY_ITEMS[@]}"; do
+          echo -e "   • $item"
+        done
+      fi
+      
+      if [[ ${#ACTIONS_TAKEN[@]} -gt 0 ]]; then
+        echo -e "\n\033[0;34m🔧 Actions Completed:\033[0m"
+        for action in "${ACTIONS_TAKEN[@]}"; do
+          echo -e "   • $action"
+        done
+      fi
+      
+      if [[ ${#WARNINGS[@]} -gt 0 ]]; then
+        echo -e "\n\033[0;33m⚠️  Warnings:\033[0m"
+        for warning in "${WARNINGS[@]}"; do
+          echo -e "   • $warning"
+        done
+      fi
+      
+      if [[ ${#ERRORS[@]} -gt 0 ]]; then
+        echo -e "\n\033[0;31m❌ Issues Found:\033[0m"
+        for error in "${ERRORS[@]}"; do
+          echo -e "   • $error"
+        done
+      fi
+      
+      FREE_SPACE=$(diskutil info / | grep -E "Free Space" | awk '{print $4 " " $5}' | sed 's/[(),]//g')
+      echo -e "\n\033[0;36m💾 System Status:\033[0m"
+      echo -e "   • Free disk space: $FREE_SPACE"
+      echo -e "   • macOS: $MACOS_VERSION"
+      echo -e "   • Downloads folder: $DOWNLOADS_SIZE"
+      echo -e "   • Desktop folder: $DESKTOP_SIZE"
+      echo -e "   • Cache folder: $CACHE_SIZE"
+      
+      echo -e "\n\033[0;35m🎯 Recommendations:\033[0m"
+      echo -e "   • System maintenance cycle completed"
+      echo -e "   • Schedule next maintenance in 1-2 weeks"
+      echo -e "   • Review detailed report: $REPORT_FILE"
+      
+      if [[ "$DOWNLOADS_SIZE" == *"G" ]] && [[ $(echo "$DOWNLOADS_SIZE" | sed 's/G.*//') -gt 10 ]]; then
+        echo -e "   • \033[0;33mConsider cleaning Downloads folder ($DOWNLOADS_SIZE)\033[0m"
+      fi
+      
+      if [[ "$CACHE_SIZE" == *"G" ]] && [[ $(echo "$CACHE_SIZE" | sed 's/G.*//') -gt 15 ]]; then
+        echo -e "   • \033[0;33mCache folder is large ($CACHE_SIZE) - normal but monitor\033[0m"
+      fi
+      
+      echo -e "\n\033[0;35m════════════════════════════════════════════════════════════════════════════════\033[0m"
+      
+      echo -e "\n\033[0;32m📄 Report saved to: $REPORT_FILE\033[0m"