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 |