name: macbook-optimizer
description: Complete MacBook optimization suite: monitoring, troubleshooting, cleanup, and performance tuning. Works on all Macs (Intel & Apple Silicon). No extra tools required.
homepage: https://github.com/T4btc/macbook-optimizer
metadata:
{
"openclaw":
{
"emoji": "💻",
"os": ["darwin"],
"requires": { "bins": ["system_profiler", "top", "ps", "df", "du"] },
},
}
💻 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:
- User: "My Mac is slow"
- Agent opens Activity Monitor → highlights CPU/Memory hogs
- Agent opens System Settings → shows relevant optimization settings
- 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:
- Always open Activity Monitor when showing CPU/Memory/Process info
- Navigate to relevant System Settings panels automatically
- Open Finder to specific folders when discussing files
- Generate visual summaries with emoji indicators (🟢🟡🔴)
- 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 |