macbook-optimizer

# 💻 MacBook Optimizer _Complete MacBook health & performance suite - No installation required_ A comprehensive, user-friendly skill for monitoring, optimizing, and troubleshooting MacBook performance. Works on **all Macs** (Intel & Apple Silicon) using built-in macOS tools. Unlike specialized tools, this provides actionable recommendations and automated fixes. ## Why This Skill is Better ✅ **No installation required** - Uses built-in macOS tools ✅ **Works on all Macs** - Intel & Apple Silicon ✅ **Actionable recommendations** - Not just metrics, but solutions ✅ **Automated fixes** - Can clean up and optimize automatically ✅ **User-friendly** - Plain language, not technical jargon ✅ **Complete suite** - Monitoring + troubleshooting + optimization ✅ **GUI-first** - Opens visual tools automatically for non-technical users ✅ **Visual reports** - Charts, graphs, and emoji indicators for easy understanding ## Capabilities ### 🔍 System Monitoring - **CPU Analysis**: Real-time CPU usage, temperature (via `powermetrics`), load averages, per-process breakdown - **Memory Health**: RAM usage, memory pressure, swap usage, identify memory leaks - **Disk Intelligence**: Space analysis, find large files/folders, duplicate detection, cache locations - **Battery Diagnostics**: Health percentage, cycle count, capacity, charging status, power consumption - **Thermal Monitoring**: System temperature, thermal state, identify overheating causes - **Network Activity**: Bandwidth usage, active connections, identify bandwidth hogs ### ⚡ Optimization Tools - **Smart Cleanup**: Automatically find and remove caches, logs, temp files, downloads, duplicates - **Process Management**: Identify resource hogs, suggest optimizations, safe process termination - **Startup Optimization**: Manage login items, background apps, reduce boot time - **Storage Optimization**: Find large files, suggest deletions, empty trash, clear caches - **Performance Tuning**: System settings recommendations, disable unnecessary services ### 🛠 Troubleshooting - **Slowdown Diagnosis**: Identify bottlenecks (CPU/memory/disk/network), root cause analysis - **Overheating Solutions**: Find hot processes, suggest cooling strategies, thermal management - **Memory Issues**: Detect leaks, suggest app restarts, memory optimization - **Disk Problems**: Full disk analysis, permission issues, disk health checks - **Battery Issues**: Health degradation, charging problems, power management ## Usage Examples **Complete system check (with GUI):** ``` Run a full system health check, show me the results visually, and fix any issues ``` **Performance optimization (GUI mode):** ``` My MacBook is slow. Open Activity Monitor and show me what's using resources ``` **Overheating issue:** ``` My MacBook is overheating. Show me the hot processes in Activity Monitor ``` **Disk cleanup (visual):** ``` Show me my disk usage visually and clean up automatically ``` **Memory problems (GUI):** ``` My Mac is using too much memory. Open Activity Monitor and highlight the memory hogs ``` **Battery health (visual):** ``` Show me my battery health in System Settings and optimize power settings ``` **Startup optimization:** ``` What's slowing down my Mac startup? Show me login items in System Settings ``` **Find large files (visual):** ``` Find all files larger than 1GB, show them in Finder, and suggest what I can delete ``` **GUI-first requests:** ``` Show me everything in Activity Monitor Open System Settings to battery settings Show me disk usage in a visual way ``` ## Advanced Commands Available The agent intelligently uses these macOS tools: **System Info:** - `system_profiler` - Complete hardware/software information - `sysctl` - System parameters and kernel settings - `sw_vers` - macOS version information **Process Monitoring:** - `top` / `htop` - Real-time process monitoring - `ps` - Process status and details - `lsof` - List open files and network connections - `launchctl list` - Background services and daemons **Resource Monitoring:** - `vm_stat` - Virtual memory statistics - `iostat` - Disk I/O statistics - `netstat` / `lsof -i` - Network connections - `powermetrics` - CPU/GPU power and temperature (Apple Silicon) - `pmset -g therm` - Thermal state (Intel Macs) **Disk Management:** - `df` - Disk space usage - `du` - Directory size analysis - `find` - Locate large files - `mdutil` - Spotlight index management **Power & Battery:** - `pmset` - Power management settings - `ioreg` - I/O registry (battery info) - `system_profiler SPPowerDataType` - Battery details **Cleanup:** - `rm` - Safe file removal (with confirmation) - `purge` - Memory purge - Cache locations: `~/Library/Caches`, `/Library/Caches`, `/var/folders` **GUI Tools (Visual Interface):** - `open -a "Activity Monitor"` - Launch Activity Monitor (CPU, Memory, Energy, Disk, Network) - `open -a "System Settings"` - Open System Settings (all system preferences) - `open -a "System Settings" && open "x-apple.systempreferences:com.apple.preference.battery"` - Battery settings - `open -a "System Settings" && open "x-apple.systempreferences:com.apple.preference.storage"` - Storage management - `open -a "System Settings" && open "x-apple.systempreferences:com.apple.LoginItems-Settings.extension"` - Login items - `open -a "Finder"` - Open Finder for file browsing - `open ~/Library/Caches` - Open Caches folder in Finder - `open ~/Downloads` - Open Downloads folder - `open "x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles"` - Privacy settings - `open "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility"` - Accessibility permissions **Visual Reports:** - Generate HTML reports with charts (CPU, Memory, Disk usage over time) - Create visual summaries with emoji indicators (🟢 Good, 🟡 Warning, 🔴 Critical) - Open relevant System Settings panels automatically based on findings ## 🎨 GUI-First Experience **For users who prefer visual interfaces**, the agent can: - 📊 **Open Activity Monitor** automatically when showing system stats - ⚙️ **Navigate System Settings** to relevant panels (Battery, Storage, Privacy) - 📁 **Open Finder** to specific folders (Caches, Downloads, Large files) - 📈 **Generate visual reports** with charts and graphs (HTML format) - 🎯 **Highlight issues** in GUI apps with clear indicators - 🔍 **Show step-by-step** with screenshots or GUI navigation **Example GUI Workflow:** 1. User: "My Mac is slow" 2. Agent opens Activity Monitor → highlights CPU/Memory hogs 3. Agent opens System Settings → shows relevant optimization settings 4. Agent provides visual summary with emoji status indicators ## Intelligent Automation The agent can: - ✅ **Automatically clean** safe caches and temp files (with user confirmation) - ✅ **Suggest optimizations** based on system analysis - ✅ **Provide step-by-step fixes** for common issues (with GUI navigation) - ✅ **Monitor continuously** if requested (via cron jobs) - ✅ **Generate visual reports** with charts, graphs, and actionable recommendations - ✅ **Open GUI tools** automatically when showing system information ## Safety & Privacy - 🔒 **Always asks before** deleting files or killing processes - 🔒 **Protects system files** and critical processes - 🔒 **Reviews before action** - shows what will be deleted - 🔒 **No data collection** - everything runs locally - 🔒 **Respects privacy** - never sends data externally ## Requirements - ✅ **macOS only** (Intel & Apple Silicon) - ✅ **No installation needed** - uses built-in tools - ✅ **Optional**: `htop` for prettier process view (`brew install htop`) - ✅ **Optional**: `mactop` for Apple Silicon detailed metrics (`brew install mactop`) ## How to Use GUI Tools When the user asks for visual information or mentions they're not technical: 1. **Always open Activity Monitor** when showing CPU/Memory/Process info 2. **Navigate to relevant System Settings** panels automatically 3. **Open Finder** to specific folders when discussing files 4. **Generate visual summaries** with emoji indicators (🟢🟡🔴) 5. **Provide step-by-step GUI navigation** instructions **GUI Navigation Commands:** - CPU issues → Open Activity Monitor, sort by CPU - Memory issues → Open Activity Monitor, sort by Memory - Battery → Open System Settings → Battery - Storage → Open System Settings → General → Storage - Login items → Open System Settings → General → Login Items - Large files → Open Finder, navigate to location, sort by size ## Comparison with Other Tools | Feature | macbook-optimizer | mactop | |---------|------------------|--------| | Installation required | ❌ No | ✅ Yes (brew) | | Works on Intel Macs | ✅ Yes | ❌ No (Apple Silicon only) | | Actionable recommendations | ✅ Yes | ❌ No (metrics only) | | Automated cleanup | ✅ Yes | ❌ No | | Troubleshooting | ✅ Yes | ❌ No | | User-friendly | ✅ Yes | ⚠️ Technical | | Complete suite | ✅ Yes | ⚠️ Monitoring only | | GUI-first experience | ✅ Yes | ❌ CLI only | | Visual reports | ✅ Yes | ❌ Text only |