Support & Documentation

What is HealthAgent?

HealthAgent is an iOS utility that extracts biometric data from Apple HealthKit and formats it into token-optimized Markdown and XML prompts tailored for AI assistants like ChatGPT, Claude, and Grok. It runs 100% on-device with zero cloud servers.

How do I integrate HealthAgent with ChatGPT or Claude?

You can connect HealthAgent in two simple ways:

• On-Demand Export: Open HealthAgent, choose your metrics (Vitals, Sleep, Workouts, or All), tap "Export Prompt", and paste the resulting clipboard content directly into your AI conversation.
• Universal Links / Custom GPTs: Configure your custom AI instructions to provide a link formatted as https://healthagentapp.com/export?scope=vitals. When you tap this link on your iPhone, HealthAgent launches automatically and prepares your context.

Which biometric categories does HealthAgent support?

HealthAgent supports core Apple HealthKit telemetry:

• Heart Metrics: Resting Heart Rate, Heart Rate Variability (HRV SDNN), and Walking Heart Rate.
• Activity: Active Energy burned, Step Count, Flights Climbed, and Distance.
• Sleep: Total Sleep duration, Sleep Efficiency, and Stage breakdowns (Core, Deep, REM).
• Workouts: Recent workout sessions, activity types, duration, and energy expenditure.
• Baselines: Automated 7-day and 30-day moving averages and percentage differentials.

How do I grant or revoke HealthKit permissions?

When you launch HealthAgent for the first time, iOS presents the official HealthKit permission sheet. You can modify these permissions at any time on your iPhone:

1. Open the Settings app on your iPhone.
2. Scroll down and tap Health.
3. Tap Data Access & Devices.
4. Select HealthAgent and toggle any metric on or off.

Is my health data sent to your servers?

Never. HealthAgent has no backend servers, no cloud telemetry, and no user accounts. All processing occurs locally within the Swift runtime on your iPhone. Only you decide when and where to send or paste your exported summaries.

What URL schemes and deep links are supported?

HealthAgent supports the native custom scheme healthagent://export and the Universal Link https://healthagentapp.com/export. Accepted query parameters include:

• scope: vitals (default), sleep, activity, workouts, or all
• range: 7d (default) or 30d