Set up a Syncky agent

A Syncky agent runs on your own computer or server. It receives the Apple Health data you choose to share from the Syncky Health app, and it can write entries back to Health that you allow. Data travels through Syncky Relay end-to-end encrypted: Relay holds sealed messages for up to 7 days and never has the key. The agent needs the Sync + Relay plan in the app; you can set it up and pair it before you pay.

The easiest way is to let an AI agent with a shell on that server do the whole setup from one link.

1. Get the setup link

The setup guide and the agent kit are not public yet. During the beta every owner gets a private link. An AI agent given that link downloads the kit, checks its checksum, installs it, registers with Relay and sends you a pairing link and a code. To get your link, write to support@syncky.app and say which app you use (see the table below).

Give the link only to your agent. Do not post it anywhere.

2. Use the relay of your app

The agent must register on the relay of the app build you use. The app refuses a pairing link from another relay (untrusted_relay).

The setup link you get is made for one of these relays.

3. What the server needs

• Node.js 22.15 or newer, below 23.
• Outbound HTTPS to the relay. The agent polls the relay, so it needs no inbound port, no public URL and no TLS certificate. Delivery by webhook is optional, for an agent that already runs behind HTTPS with a public address.
• Access to the npm registry once, to install the kit.

4. What is in the kit

• agent/: the reference agent syncky-agent, a Node.js command-line program, with its guide for AI agents.
• protocol/: the data types, units, schemas and test vectors. Keep it next to agent/: the agent reads it from there.
• examples/minimal-agent/: a short teaching example, not needed to run.

The kit has no node_modules. npm ci in agent/ downloads the agent's runtime packages from the npm registry; npm ci --omit=dev also skips ajv, which only the tests use. The kit's source will be the public repository syncky/syncky-open (Apache-2.0).

5. Pair your iPhone

When the agent is registered it sends you a pairing link and a code of three groups of digits. In Syncky Health open Settings → Connections → + → AI agent → Paste link, paste the link, then pick the code's last group among three choices. The link works for 10 minutes. Pair within 24 hours of the setup: Relay deletes an agent that no iPhone joined by then.

Then allow Health access when the app asks, and choose per type what the agent may read and write. Tap Sync now once to see the first data arrive; after that the app syncs on its own while your iPhone is unlocked.

6. Your data on the server

Relay sees your Health data only as sealed messages; what it reads in clear is who sent what to whom and when, and its own notices about members and plans. The agent decrypts the sealed messages and stores your Health data in clear in its own folder on the server, so run it on a machine only you can log in to, on an encrypted disk. Delete Relay data in the app tells the agent you are leaving. The agent still has the Health data it received from your iPhone; whoever runs it decides what happens to it and can delete it with syncky-agent forget <member_id> --yes --commands.

Whoever runs the agent is responsible for the data it holds. If you run it for yourself, it is your own data on your own machine. If you run it for someone else, you are their data controller under the laws that apply to you, and you need their agreement; Syncky's Privacy Policy covers only the app and Relay. The agent code is published as is under the Apache License 2.0; the security properties described here are those of the current implementation, not a guarantee.