Proactive health monitoring for AI agents. Apple Health integration, pattern detection, anomaly alerts. Built for agents caring for humans with chronic conditions.
Proactive health monitoring for AI agents. Apple Health integration, pattern detection, anomaly alerts. Built for agents caring for humans with chronic conditions.
Configure: JSON format, iCloud Drive sync, hourly export
Export folder: iCloud Drive/Health Auto Export/
2. Configure the Skill
Create config.json in the skill directory:
{"human_name":"Your Human","data_source":"~/Library/Mobile Documents/com~apple~CloudDocs/Health Auto Export","import_interval":"hourly","alert_channel":"telegram","thresholds":{"temperature_high":100.4,"temperature_low":96.0,"heart_rate_high":120,"heart_rate_low":50},"baseline_period_days":14}
3. Set Up Cron Import
Add to your agent's cron (hourly):
{"name":"Health Import","schedule":{"kind":"cron","expr":"0 * * * *"},"payload":{"kind":"systemEvent","text":"Run health import and check for anomalies"},"sessionTarget":"main"}
4. Add to Heartbeat
In your HEARTBEAT.md:
## Health Check (if concerning patterns)
If health data shows anomalies, alert human via preferred channel.
Scripts
scripts/import_health.py
Imports Apple Health JSON exports and stores in local database.
python3 scripts/import_health.py
scripts/analyze.py
Runs pattern detection on stored data, outputs alerts.
python3 scripts/analyze.py --days 7
scripts/summary.py
Generates human-readable health summary.
python3 scripts/summary.py --period week
Data Storage
All data stays local in data/:
readings.json — raw metric values with timestamps
baselines.json — calculated normal ranges per metric
alerts.json — triggered alerts history
patterns.json — detected correlations
Privacy: Nothing leaves your machine. No cloud. No telemetry.
Alert Examples
Fever Detection:
🌡️ Temperature Alert
Current: 100.8°F
Baseline (14d avg): 98.2°F
Deviation: +2.6°F
Action: Monitor closely. Consider hydration, check for infection signs.