maintaining-macos-health

Solid

Hands-on playbook for macOS disk cleanup, dev-machine optimization, and proactive health alerting. Use when the Mac is full or slow, when a kernel panic / watchdog timeout / vm-compressor-space-shortage / Jetsam event happened, when the user asks to free disk space, audit storage, set up disk/memory alerts, or restore the same monitoring on a new Mac. Built around Mole (`mo` CLI) for safety guards plus a custom LaunchAgent-based alerter for active warnings. Covers Apple Silicon laptops with heavy AI/Docker workloads. Not for general macOS support, hardware diagnostics, networking issues, GUI / window-manager bugs, Time Machine recovery, broken app installs, or app-specific performance problems unrelated to disk or memory pressure.

AI & Automation 77 stars 3 forks Updated 6 days ago MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
63
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Maintaining macOS Health Recovery and prevention playbook for macOS disk and memory crises. Validated against a real watchdog-timeout kernel panic on Apple Silicon caused by `vm_compressor` segments saturated to 100 % with the disk over 90 % full. The same playbook works for routine cleanup or first-time setup on a new machine. ## Table of contents - [When to use](#when-to-use) - [Skill layout](#skill-layout) - [Core mental model](#core-mental-model) - [Standard workflows](#standard-workflows) - [A. "Free space NOW" (incident response)](#a-free-space-now-incident-response) - [B. "Set up alerting" (new machine or first time)](#b-set-up-alerting-new-machine-or-first-time) - [C. Alerter stopped working / making noise](#c-already-have-alerter-but-it-stopped-working--making-noise) - [D. "Uninstall an app cleanly"](#d-uninstall-an-app-cleanly) - [Safety rules (non-negotiable)](#safety-rules-non-negotiable) - [Domain quirks captured](#domain-quirks-captured) - [Outcomes scale](#outcomes-scale) ## When to use Trigger on any of: - Disk free < 20 % or user complains about being out of space - Watchdog-timeout / kernel panic / "no checkins from watchdogd" - New `JetsamEvent-*.ips` with `vm-compressor-space-shortage` - "Mac is slow", swap > 6 GB, sustained Critical memory pressure - User wants to set up monitoring/alerting from scratch - Migration to a new Mac → restore the same alerter - General "clean my Mac" / "audit storage" / "free space" requests ## Skill layout |...

Details

Author
CodeAlive-AI
Repository
CodeAlive-AI/ai-driven-development
Created
4 months ago
Last Updated
6 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

clean-machine

Audit + clean a developer's machine — dotfolders, caches, language toolchains, package globals — with per-target classification, risk surfacing (auth, processes, side effects), and explicit confirmation. Produces `.forsvn/artifacts/meta/records/machine-cleanup-*.md`. Not for cleaning code (use clean-code) or for triaging user files (those need human review).

10 Updated today
hungv47
Data & Documents Listed

system-cleanup

Use when a Linux disk is filling up or the user asks to free space / clean the system / "系统盘满了" / move large files off the system disk. Diagnose where the space went (df / du / dpkg / snap / docker), then give a prioritized, risk-tagged plan — do safe user-level deletions, and LIST the sudo items for the user to run (default to advise-then-confirm; this kind of box often has no passwordless sudo, so use pkexec or hand over the commands). Covers the VS Code WebStorage PDF-cache bloat bug, old-kernel pile-up, snap/journal/apt/docker caches, and NTFS data-disk write failures.

0 Updated today
jajupmochi
Data & Documents Listed

skill-issue

Audit and review all installed agent skills. Run on-demand or via cron to get a health report: skill inventory, usage tracking, version checks, dependency health, and actionable recommendations (keep, update, review, remove). Use when asked to review skills, check for skill updates, find unused skills, or audit the skill ecosystem.

23 Updated 4 months ago
krispuckett
Data & Documents Listed

skill-issue

Audit and review all installed agent skills. Run on-demand or via cron to get a health report: skill inventory, usage tracking, version checks, dependency health, and actionable recommendations (keep, update, review, remove). Use when asked to review skills, check for skill updates, find unused skills, or audit the skill ecosystem.

43 Updated 3 months ago
diegosouzapw
Web & Frontend Listed

skill-issue

Audit and review all installed agent skills. Run on-demand or via cron to get a health report: skill inventory, usage tracking, version checks, dependency health, and actionable recommendations (keep, update, review, remove). Use when asked to review skills, check for skill updates, find unused skills, or audit the skill ecosystem.

3 Updated today
Shubhgaji