macOS-app

Health.md voor Mac heeft twee lokale taken:

de app ontvangt exporttaken van de iPhone en schrijft bestanden naar een map die je kiest;
de app host de loopback-CLI, query-API, versleutelde gezondheidscontext en MCP-adapter voor lokale agents.

Apple Health blijft op de iPhone. De Mac-app leest HealthKit niet rechtstreeks uit.

Belangrijkste onderdelen

Synchronisatie

Toont of de Mac vindbaar en gereed is voor exporttaken vanaf de iPhone.

Bestemmingsmap

Bewaart een security-scoped bladwijzer voor uitvoer in Markdown, JSON, CSV en Bases, plus periodeoverzichten, ZIP-bestanden en dagelijkse notities.

Schema

Toont de planning en gereedheid aan de Mac-kant. De iPhone blijft de HealthKit-gegevens leveren.

Geschiedenis

Houdt exportresultaten, persistente voortgang, fouten en informatie voor nieuwe pogingen bij voor bestanden die op de Mac worden geschreven.

Instellingen

Toont de status van de bestemming, bewaarbeheer voor versleutelde context en de lokale CLI-configuratie.

Menubalk

Geeft snel toegang tot status, instellingen en de app terwijl Health.md lokaal beschikbaar blijft.

CLI

Installeert de gebundelde hulpprogramma's healthmd en healthmd-mcp, kopieert configuratieprompts, installeert de optionele agentskill en toont geteste opdrachten.

Een Mac-bestemming instellen

Installeer en open Health.md op de Mac.
Kies een bestemmingsmap op de lokale schijf, in iCloud Drive of in een Obsidian-kluis.
Schakel op de iPhone de Mac-verbinding in via het tabblad Synchronisatie.
Kies op de iPhone Verbonden Mac als exportbestemming.
Configureer de export en tik op Exporteren.

De iPhone legt de HealthKit-gegevens en een momentopname van de actieve instellingen vast. Huidige peers dragen afgebakende partities over die met checksums zijn gevalideerd. De Mac gebruikt de productie-exporters en schrijft de gevraagde bestanden.

Beperking van HealthKit.

De Mac kan Apple Health niet zelfstandig opvragen. Voor nieuwe exports en nieuwe agentcontext moet de verbonden iPhone-app geopend zijn. Gecachte queries op versleutelde context kunnen zonder nieuwe iPhone-verbinding worden uitgevoerd als de opgeslagen dekking volstaat.

CLI en agents configureren

Open het onderdeel CLI in de Mac-app om:

de exacte paden van de ondertekende hulpprogramma’s in deze appbundel te bekijken;
aliassen of opdrachten voor symbolische koppelingen in ~/.local/bin te kopiëren;
een configuratieprompt voor een agent te kopiëren;
de optionele skill healthmd-cli te installeren in een map die je kiest;
opdrachten voor status, doctor, extractie, queries, slaap, training, work-outs, dekking en export te bekijken;
veelvoorkomende gereedheidsfouten te controleren.

De app wijzigt nooit shell-opstartbestanden en installeert niets in een systeemmap zonder dat jij daarvoor een actie uitvoert.

Begin met:

healthmd doctor
healthmd metrics list --category Sleep
healthmd extract --category Sleep --yesterday --output sleep.json
healthmd query --category Sleep --yesterday

Lees Health.md-CLI voor de zelfstandige client en Lokale agents voor de queryarchitectuur.

Versleutelde gezondheidscontext

Nieuwe query- en bewijsverzoeken gebruiken een afzonderlijke modus voor het ophalen van context. De iPhone leest exact het gevraagde bereik van meetwaarden, bronnen, datums en details. Er worden geen exportbestanden gemaakt en opgeslagen exportvoorkeuren veranderen niet.

De Mac bewaart elke compacte eigenaarsdag in een afzonderlijk geauthenticeerde AES-256-GCM-blob. Een willekeurige versleutelingssleutel staat in een sleutelhangeritem dat alleen op dit apparaat en na ontgrendeling beschikbaar is. Bestandsnamen zijn willekeurig en onthullen geen datums of namen van meetwaarden.

Instellingen toont het aantal versleutelde eigenaarsdagen en het datumbereik. Twee afzonderlijke acties beheren het bewaren:

Oudere context verwijderen verwijdert eigenaarsdagen van vóór de gekozen grens;
Alle versleutelde context verwijderen verwijdert alle contextbestanden en de speciale sleutel in de sleutelhanger.

Het verwijderen van context verwijdert nooit Apple Health-gegevens, exportbestanden, bladwijzers voor Mac-bestemmingen of inloggegevens van verbonden providers.

Grens van de loopback-API

De Mac-app luistert op 127.0.0.1 en ::1 via poort 17645 naar lokale routes voor status, export, queries, bewijs, verversing en persistente taken.

Er is geen bearer-token of agentregistratie. Elk lokaal proces kan de API aanroepen terwijl de app geopend is. Stel de poort nooit bloot en gebruik geen proxy of tunnel naar een andere computer.

Het gesandboxte hulpprogramma healthmd-mcp accepteert alleen canonieke HTTP-loopbackeindpunten. De tools bieden geen shell, willekeurige bestanden, SQL, URL-ophaalacties, resources, prompts, rootmappen of sampling.

Direct CLI-toegang staat los van de Mac-app

De iPhone-instelling Direct CLI-toegang maakt een afzonderlijke vertrouwensrelatie tussen een CLI die rechtstreekse toegang ondersteunt en de iPhone. Daarmee kan de CLI voor onbewerkte exports, canonieke extractie, gegenereerde bestanden, status, hervatten en annuleren buiten de Mac-app om werken.

De rechtstreekse modus gebruikt de versleutelde querycontext van de Mac-app niet. De platformonafhankelijke opdracht healthmd mcp serve voert in plaats daarvan nieuwe getypeerde queries rechtstreeks uit op de iPhone-app op de voorgrond, met dezelfde identiteit van het uitvoerbare bestand als bij de koppeling. Lees CLI rechtstreeks naar de iPhone voor koppeling en platformondersteuning.