E EidosAGI
Agent Tool

apple-a-day

Agent-native Mac health toolkit. 9 checks, zero dependencies, plain english.

pip install apple-a-day
View on GitHub 63 downloads/mo v0.3.1 Mar 24, 2026

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.

A checkup

Agents run on machines that drift. Disks fill up, Homebrew links break after upgrades, LaunchAgents crash-loop in the background, and nobody notices until the agent starts hitting weird errors. Apple-a-day gives the agent awareness of its own host — 9 checks, each finding tagged with a severity and a fix command the agent can run directly.

1. aad checkup — 9 checks, the agent sees its host

agent · host
aad checkup --min-severity warning apple-a-day running 9 checks... crash-loops com.docker.vmnetd dying 14× in last hour fix: sudo launchctl unload /Library/Launch.../com.docker.vmnetd.plist disk-health 4.2 GB free on /, Time Machine snapshots using 38 GB fix: tmutil deletelocalsnapshots / homebrew 12 outdated packages, 3 broken dylib links fix: brew update && brew upgrade && brew doctor memory-pressure green · 18% wired · swap 0 B security SIP on · Gatekeeper on · FileVault on ... summary 3 warnings · 0 critical · 6 green

2. Agent runs the fixes, confirms clean

agent · host (after)
# agent executes the three fix commands in sequence sudo launchctl unload .../com.docker.vmnetd.plist tmutil deletelocalsnapshots / 37.8 GB reclaimed brew update && brew upgrade 12 packages updated aad checkup crash-loops no recurring failures disk-health 42 GB free on / homebrew 0 outdated · 0 broken links memory-pressure green security green ... summary 9 green · 0 warnings · 0 critical

Zero dependencies, pure Python. The --json flag makes every finding machine-readable with severity + fix so agents can triage and act without human translation.

What it checks

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.