DevOps & CloudDocumentedScanned

macbook-optimizer

Complete MacBook optimization suite: monitoring, troubleshooting, cleanup.

Share:

Installation

npx clawhub@latest install macbook-optimizer

View the full skill documentation and source below.

Documentation

πŸ’» 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

    Featuremacbook-optimizermactop
    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