apple-a-day

What it does

AI agents run on machines. Machines have disk space, memory pressure, crash loops, and security gaps. apple-a-day gives agents awareness of the Mac they're running on — 9 checks, every finding with a severity, plain-english explanation, and fix command.

What it checks

• Crash loops — services dying repeatedly via DiagnosticReports
• Kernel panics — panic logs decoded into human-readable causes
• Dylib health — broken dynamic library links after brew upgrades
• Memory pressure — RAM pressure level and swap usage
• Disk health — APFS state, free space, Time Machine snapshot bloat
• Launch agents — crash-looping, rogue, or forgotten launchd services
• Homebrew — outdated packages, doctor warnings, broken links
• Security — SIP, Gatekeeper, FileVault, XProtect freshness
• Network — Wi-Fi signal quality, speed test, responsiveness

Install

pip install apple-a-day

Usage

# CLI — run all checks
aad checkup

# Structured JSON for agent parsing
aad checkup --json --min-severity warning --fields severity,summary,fix

# Python — programmatic access
from apple_a_day.runner import run_all_checks

report = run_all_checks()
for r in report.results:
    for f in r.findings:
        if f.severity.value == "critical":
            print(f.summary, f.fix)

Zero dependencies. Pure Python. Every finding includes a severity, a plain-english explanation, and a fix command the agent can run.