RuochenLyu/apple-health-analyst

52 stars · Last commit 2026-04-16

Privacy-first Apple Health analyzer — cross-metric insights, behavioral patterns, and health reports. Agent skill for Claude Code, Codex & Cursor.

README preview

# apple-health-analyst

[![npm version](https://img.shields.io/npm/v/apple-health-analyst)](https://www.npmjs.com/package/apple-health-analyst)
[![npm downloads](https://img.shields.io/npm/dm/apple-health-analyst)](https://www.npmjs.com/package/apple-health-analyst)
[![license](https://img.shields.io/npm/l/apple-health-analyst)](https://github.com/RuochenLyu/apple-health-analyst/blob/main/LICENSE)

[中文文档](https://github.com/RuochenLyu/apple-health-analyst/blob/main/README.zh-CN.md)

Analyze Apple Health export data locally, generating either a health report or a training report with cross-metric reasoning, long-term trends, and offline HTML output.

Not a data dashboard — you can already see the data on your phone. This tool's value is **interpreting your data like a health advisor**: How are sleep and recovery linked? How does schedule regularity affect HRV? Does training load match recovery capacity?

**Samples:** [Health (EN)](https://ruochenlyu.github.io/apple-health-analyst/) · [Training (EN)](https://ruochenlyu.github.io/apple-health-analyst/training.report.html) · [健康报告](https://ruochenlyu.github.io/apple-health-analyst/zh/report.html) · [运动报告](https://ruochenlyu.github.io/apple-health-analyst/zh/training.report.html)

![Sample Report](https://raw.githubusercontent.com/RuochenLyu/apple-health-analyst/main/docs/screenshot-en.png)

## Features

- **Cross-metric correlation analysis** — Sleep-HRV coupling, training-recovery balance, schedule regularity assessment
- **Workout-type trend analysis** — Break out long-term trends for specific workouts like boxing, strength training, or cycling

View full repository on GitHub →