apple-health-analyst CLI
A CLI and skill analyse an Apple Health export on your computer and build offline health and training reports.
- 64 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The skill reads personal health data from the export, and with a cloud model the structured JSON goes to its provider.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/apple-health-analystDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skill reads personal health data from the export, and with a cloud model the structured JSON goes to its provider.
This is third-party code. Review the repository files before installing.
What it does
The tool takes a ZIP Apple Health export and builds two linked reports in HTML and Markdown: one on health and one on training. It looks for patterns between metrics: whether sleep moves with heart rate variability and whether recovery supports the load. Among sports it analyses those actually present in the export. In the training report load is described by a 42-day baseline, a 7-day recent load and their balance, as MET-minute estimates rather than direct fitness measures. There is no single health score: the tool shows personal trends, sample coverage and data gaps. ZIP parsing and output run locally with no telemetry, and the skill installs with `npx skills add`.
Who it is for. People who keep data in Apple Health and want long-trend analysis of sleep, recovery and training without sending the export to the cloud.
Good fit when
- A multi-year export becomes a report on sleep and recovery.
- A training report is built with emphasis on one sport, for example boxing.
- You check whether an irregular schedule relates to heart rate variability.
- A self-contained HTML report in English or Chinese is needed.
Not a fit when
- You need a medical diagnosis or treatment advice.
- Your data lives in a third-party tracking service.
- You expect a single health score in one number.
Example request
Analyse my Apple Health export at /path/to/export.zip and produce only the training report with an emphasis on running.Limitations
The report describes associations between records rather than causes and does not replace a doctor. Load in MET-minutes is an estimate and measures neither fitness nor readiness directly. Parsing and rendering run locally, but if a cloud model writes the report narrative the structured JSON goes to its provider, as `PRIVACY.md` states. Node.js is needed to run it, and the `--lang` flag is enough for the report language. Prepare the export from the Health app in advance.
How to disable. Remove the skill with `npx skills remove apple-health-analyst` and delete the `output/` folder with reports. Delete the ZIP export itself by hand.
FAQ
How do I install the tool?
Run `npx skills add RuochenLyu/apple-health-analyst`. It works with Claude Code, Codex, Cursor and dozens more agents.
Which commands run under the hood?
`prepare` parses the ZIP and writes `summary.json` and `insights.json`, and `render` builds HTML and Markdown from the insights and the model narrative.
Can I get only one report?
Yes, tell the agent "Only generate the health report" or "Only generate the training report".
Does data go to the cloud?
ZIP parsing and rendering run locally with no telemetry. But if a cloud model writes the narrative, it receives the structured JSON.
In which languages is the report available?
English and Chinese, set by the `--lang` flag or the language of your request.
Discussion
No questions or reviews yet.
Related
CLI toolsClaude Code commands and skills help organize personal health documents and prepare summaries from saved records
A read-only MCP server that brings WHOOP recovery, sleep, HRV, strain and workouts to Claude, Codex and Cursor.
An MCP server over your local Zepp and Amazfit database: agents read sleep, heart rate and workouts and draft plans
A skill processes your WeChat favorites on a Mac and builds an HTML report with search, filters and activity charts.
Twelve skills build a training plan, meal targets and an offline workbench page, with install checks that verify every file.
A CLI that analyzes Claude Code and Codex sessions: standup summary, productivity report and tips in the status line
README in short
The tool puts records into a long personal context rather than drawing a dashboard. Synthetic sample reports are on the project site.