healthkit-sync
by mneves75
Apple Apps & ServicesBrief
iOS HealthKit data sync CLI commands and patterns.
Description
What This Skill Does
healthkit-sync provides CLI commands and patterns for syncing Apple HealthKit data from an iPhone to a Mac over a local network. It uses mTLS certificate pinning and macOS Keychain storage to keep health data on-device and off cloud services. The skill covers pairing, data fetching, and the underlying iOS app architecture.
Syncing over local network with mTLS and TOFU certificate pinning keeps health data off third-party cloud services entirely.
When to Use It
- Export a week of step counts to CSV for a spreadsheet
- Pull sleep stage data for a personal health dashboard
- Fetch heart rate variability trends after workouts
- Automate daily health data backups to a local file
- Diagnose pairing or connection issues with the healthsync CLI
Example Workflow
User asks: fetch my step count and heart rate for January 2026 as JSON
- 1
Run
healthsync statusto confirm device is paired and reachable - 2
Run
healthsync typesto confirm steps and heartRate are enabled - 3
Run
healthsync fetch --start 2026-01-01T00:00:00Z --end 2026-01-31T23:59:59Z --types steps,heartRate --format json - 4
Pipe output through
jqto inspect or filter the results
JSON array of timestamped step count and heart rate samples for January 2026
Requirements
- healthsync CLI installed on macOS (~/.healthsync/config.json)
- iOS Health Sync app installed on iPhone
Installation
clawhub install mneves75/healthkit-syncRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.