macOS-App

Health.md für Mac erfüllt zwei lokale Aufgaben:

Die App empfängt Exportaufträge vom iPhone und schreibt Dateien in einen von Ihnen gewählten Ordner.
Sie hostet die Loopback-CLI, die Abfrage-API, den verschlüsselten Gesundheitskontext und den von lokalen Agenten verwendeten MCP-Adapter.

Apple Health verbleibt auf dem iPhone. Die Mac-App liest HealthKit nicht direkt.

Hauptbereiche

Synchronisierung

Zeigt, ob der Mac auffindbar und für iPhone-Exportaufträge bereit ist.

Zielordner

Speichert ein security-scoped-Lesezeichen für Markdown-, JSON-, CSV-, Bases-, Roll-up-, ZIP- und Daily Note-Ausgaben.

Zeitplan

Zeigt den Zeitplan und die Einsatzbereitschaft auf dem Mac. Die HealthKit-Daten liefert weiterhin das iPhone.

Verlauf

Erfasst Exportergebnisse, wiederaufnehmbaren Fortschritt, Fehler und Wiederholungskontext für auf dem Desktop geschriebene Dateien.

Einstellungen

Zeigt die Verfügbarkeit des Ziels, Aufbewahrungsoptionen für verschlüsselten Kontext und die lokale CLI-Konfiguration.

Menüleiste

Bietet schnellen Zugriff auf Status, Einstellungen und App, während Health.md lokal verfügbar bleibt.

CLI

Installiert die mitgelieferten Helfer healthmd und healthmd-mcp, kopiert Einrichtungs-Prompts, installiert optional den Agenten-Skill und zeigt getestete Befehle.

Mac-Ziel einrichten

Installieren und öffnen Sie Health.md auf dem Mac.
Wählen Sie einen Zielordner auf einem lokalen Laufwerk, in iCloud Drive oder in einem Obsidian-Vault.
Aktivieren Sie auf dem iPhone im Tab „Synchronisierung“ die Mac-Verbindung.
Wählen Sie auf dem iPhone „Verbundener Mac“ als Exportziel.
Konfigurieren Sie den Export und tippen Sie auf „Export“.

Das iPhone erfasst HealthKit-Daten und eine Momentaufnahme der wirksamen Einstellungen. Aktuelle Gegenstellen übertragen begrenzte, mit Prüfsummen validierte Partitionen. Der Mac verwendet die produktiven Exporter und schreibt die angeforderten Dateien.

HealthKit-Einschränkung.

Der Mac kann Apple Health nicht selbstständig abfragen. Für neue Exporte und Agentenkontext muss die verbundene iPhone-App geöffnet sein. Zwischengespeicherte verschlüsselte Abfragen können ohne neue iPhone-Verbindung ausgeführt werden, wenn die gespeicherte Abdeckung ausreicht.

CLI- und Agenteneinrichtung

Öffnen Sie in der Mac-App den Bereich CLI, um:

die exakten Pfade der signierten Helfer in diesem App-Bundle anzuzeigen;
Aliasse oder Befehle für symbolische Verknüpfungen unter ~/.local/bin zu kopieren;
einen Prompt für die Einrichtung durch einen Agenten zu kopieren;
den optionalen Skill healthmd-cli in einem Ordner Ihrer Wahl zu installieren;
aktuelle Befehle für Status, Diagnose, Extraktion, Abfrage, Schlaf, Training, Trainingseinheiten, Abdeckung und Export anzuzeigen;
häufige Bereitschaftsfehler zu prüfen.

Die App bearbeitet niemals Startdateien Ihrer Shell und installiert ohne Ihr Zutun nichts in einem Systemverzeichnis.

Beginnen Sie mit:

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

Informationen zur Backend-Auswahl finden Sie unter Health.md CLI, die Abfragearchitektur unter Lokale Agenten.

Verschlüsselter Gesundheitskontext

Neue Abfragen und Nachweisanfragen verwenden einen eigenen Modus zur Kontexterfassung. Das iPhone liest exakt den angefragten Umfang für Metrik, Quelle, Datum und Detailtiefe. Dabei werden weder Exportdateien erzeugt noch gespeicherte Exporteinstellungen geändert.

Der Mac speichert die Daten jedes kompakten Inhabertags in einem separat authentifizierten AES-256-GCM-Blob. Ein nur auf diesem Gerät verfügbarer und im entsperrten Zustand zugänglicher Schlüsselbund-Eintrag enthält den zufälligen Verschlüsselungsschlüssel. Dateinamen sind zufällig und verraten weder Daten noch Metriknamen.

Die Einstellungen zeigen die Anzahl und den Datumsbereich der verschlüsselten Inhabertage. Zwei unabhängige Aktionen steuern die Aufbewahrung:

Älteren Kontext löschen entfernt Inhabertage ausschließlich vor dem gewählten Stichtag.
Gesamten verschlüsselten Kontext löschen entfernt alle Kontextdateien und den zugehörigen Schlüsselbund-Schlüssel.

Die Kontextaufbewahrung löscht niemals Apple Health-Daten, Exportdateien, Lesezeichen für Mac-Ziele oder Zugangsdaten verbundener Anbieter.

Grenze der Loopback-API

Die Mac-App stellt lokale Routen für Status, Export, Abfragen, Nachweise, Aktualisierungen und persistente Aufträge auf 127.0.0.1 und ::1 an Port 17645 bereit.

Es gibt weder Bearer-Token noch Agentenregistrierung. Jeder lokale Prozess kann die API aufrufen, solange die App geöffnet ist. Stellen Sie den Port niemals einem anderen Rechner bereit und verwenden Sie dafür weder Proxy noch Tunnel.

Der sandboxgeschützte Helfer healthmd-mcp akzeptiert ausschließlich kanonische HTTP-Loopback-Endpunkte und stellt Tools ohne Shell, beliebige Dateien, SQL, URL-Abrufe, Ressourcen, Prompts, Roots oder Sampling bereit.

Direct CLI Access ist getrennt

Die iPhone-Einstellung Direct CLI Access schafft eine separate Vertrauensbeziehung zwischen einer direktfähigen CLI und dem iPhone. Sie kann die Mac-App für Rohdatenexporte, kanonische Extraktion, generierte Dateien, Status, Fortsetzung und Abbruch umgehen.

Der direkte Modus verwendet nicht den verschlüsselten Abfragekontext der Mac-App. Stattdessen führt das portable healthmd mcp serve neue typisierte Abfragen direkt auf dem im Vordergrund geöffneten iPhone aus und verwendet dabei dieselbe ausführbare Identität wie bei der Kopplung. Informationen zu Kopplung und Plattformunterstützung finden Sie unter Direkte iPhone-CLI.