Cloud Sync
Your data lives on your devices. Cloud Sync keeps a copy in the cloud: it is your backup, and on Pro it keeps all your devices the same.
Cloud Sync is on when you sign up, on Free and on Pro.
Free and Pro
| Free | Pro | |
|---|---|---|
| Devices in Cloud Sync | One device | All your devices |
| Your data (text, numbers, settings) | No practical limit | No practical limit |
| Your files (photos, PDFs, videos) | 200 MB | 50 GB, plus 100 GB more for about $3 a month |
| How fast the cloud copy updates | A few minutes after each change | Within seconds, and every device is the same |
| Agents and automations in the cloud | No | Yes, while your devices are off |
- A browser linked to the desktop app on the same computer is part of that computer. It is not a second device.
- On Free, files over 200 MB stay only on your device. The app says so plainly, for example “1.4 GB of files are only on this computer”. Your data always syncs.
- On Free, data from outside services (such as sleep from Whoop) waits in the cloud until your device collects it.
Where: three choices for each collection and entry
Each collection has a Where setting, in its Share & privacy panel. It has three values:
- Cloud Sync (the default). On your devices and in the cloud. Kaizendex protects it and can help you recover it. Agents in the cloud can use it (Pro).
- Cloud Sync, end-to-end encrypted (later). The same, but your devices lock it before it leaves them. End-to-end encrypted means only your devices hold the key. Not even Kaizendex can read it.
- This device only. It never leaves this device, not even its name. It does not appear on your other devices at all, and it is not in the cloud.
An entry follows its collection, unless you give the entry its own value. Then the entry wins.
Settings → Cloud Sync holds the starting value for new collections. Changing Where is a
change only you can make: the folder, kzx and
agents can only suggest it.
Example: your Workouts stay on plain Cloud Sync. You set your Diary collection to end-to-end encrypted: it is on your laptop and your phone, and the cloud holds only a locked copy. One Diary entry, “Therapy notes”, you set to This device only: it stays on your laptop, and your phone never sees it.
This device only keeps its name too. A link to “Therapy notes” from another entry syncs
only as a hidden id, so your phone shows “A private item”. It is never sent to a cloud AI
model; the AI receipt shows “1 private item”. “Version this folder with Git” never pushes it.
If your ~/Kaizendex folder sits inside OneDrive, iCloud Drive, Dropbox or Google Drive, the
app warns you: “Your cloud drive uploads this folder, This device only collections included.”
| Cloud Sync | Cloud Sync, end-to-end encrypted | This device only | |
|---|---|---|---|
| On your other devices | Yes | Yes | No, not even its name |
| In the cloud | Yes | Yes, locked | No |
| Kaizendex can read it | We do not look, but we technically could | No | It never reaches us |
| Agents in the cloud (Pro) | Yes | Only with a key you give them for that collection | Never |
| If you lose a device | Kaizendex can help you recover it | Another of your devices, your 12 recovery words or your folder unlock it (a passkey too, where it works) | Gone, unless you backed up that device |
Plain Cloud Sync is encrypted on the network and on disk, and every person has their own box. But “we do not look” is not “we cannot look”: a court order, a serious bug or a rogue insider could reach it. Only end-to-end encryption means we cannot. It comes later, after an outside security audit. See End-to-end encryption.
Turn Cloud Sync on or off
Cloud Sync is on when you sign up. You can turn it off only in the desktop app. A browser on its own and a phone always use Cloud Sync: a browser can lose its data when it is cleared, and a phone has no folder.
-
In the desktop app, open Settings → Cloud Sync.
-
Clear the Cloud Sync checkbox. This is a change only you can make, so the app asks for Face ID, a fingerprint, Windows Hello or your computer password.
-
On Pro with several devices, pick the one device that keeps the data. A confirm lists your other devices. After you confirm, they delete their copy.
-
Syncing stops at once. The cloud copy is deleted after 30 days, so you can undo a mistake. To delete it at once, click Delete now.
With Cloud Sync off, your data lives only on that computer: in the desktop app’s database and
in your ~/Kaizendex folder. Back up the folder yourself, with Time Machine on a Mac or File
History on Windows.
To turn Cloud Sync on again, select the checkbox. The desktop app uploads your data.
In the desktop app today
The desktop app starts with Cloud Sync off. Your data stays on your computer until you turn it on yourself. Nothing is sent before that.
Turning sync on is one guided flow. It goes on by itself; you click only where it asks.
-
Settings → Data sync shows one card, Back up and sync your data. Click Turn on sync. (The row Back up and sync in the sidebar’s bottom-left corner, and the line “Your data lives only on this computer” at the top of the Home hub, do the same. That line’s X hides it for 14 days.) Your normal browser opens the page Create your account or sign in. Make an account with a passkey, or sign in with Google, an email code or a passkey. The page then asks: “Sign in to the Kaizendex app on this computer?” Click Continue. The browser hands the sign-in back to the app, and the tab says you can close it. Until then the app says Finish in your browser, with Open the page again and Cancel. After 10 minutes it stops by itself. The app keeps the sign-in in your computer’s keychain, never in a file.
-
The app goes on by itself: Backing up your data… (a full copy of your account on this computer), then Checking your account…. No click.
-
One main button:
- Use this computer’s data (a new account): click Sync this computer. Choose what stays on this computer opens the list of collections; a ticked one never leaves this computer. None is ticked by default.
- Your account has your data from another device: Keep both apart (this computer has data) or Get my data (it is empty).
Not now puts it off. The setup is back at the same step the next time you open the app or Data sync.
-
The line says what happens: Uploading your data…, Uploading files… 12 of 150, then Synced: “Now open Kaizendex on your phone or another computer and sign in with the same account”, with the address and a QR code of it. A browser that waits for this computer shows its six digits here, with Approve. Nothing is uploaded before the backup is made and you click.
If your account is deleted (or its sign-in ends) while this computer syncs, Data sync says You were signed out above the same card. Your data on this computer stays. Click Turn on sync: an account that still has this computer goes on syncing; a new account starts the setup from zero.
To join, the computer must be empty. Two accounts are never mixed. A computer that already holds data makes a new, empty Kaizendex folder for the synced account. Your folder stays where it is, untouched. See Your devices.
Settings → Data sync then shows where sync stands:
| It says | What it means |
|---|---|
| “Everything is synced” | The cloud has every change. The line under it says when it last synced. |
| “3 changes waiting” | 3 changes are only on this computer. They go up by themselves. |
| “Offline” | No connection. Your changes are saved here and sync when the connection is back. |
| “Sync is paused” | You ticked Pause sync on this computer. Untick it to go on. |
| “Signed out” | Sign in again. Your changes are saved here and go up after. |
| “Waiting for your answer” | Another device deleted many entries. See below. |
| “Sync stopped on this computer” | Sync could not go on safely. The page says why, and the way back. |
- Many deletes wait for you. When another device deletes many entries at once, nothing is deleted here yet. The page shows how many, and from which collections. Click Keep them or Delete them. Keep brings them back on every device.
- Two versions of one page. When a page is first written on two devices before they have met, the newer page stays. The other is kept under Kept aside, so nothing is lost.
- Delete my cloud account. It deletes the copy in the cloud and signs out every device. Everything on this
computer stays. It cannot be undone, so you type
delete, then prove it is you. With a passkey: a small window asks for it. With no passkey: the cloud mails you a six-digit code, and you type it in Settings. With Google and no mail: you sign in with Google again in your browser. - Your other folder. After you joined in a new folder, the folder you used before is still there. Open it takes you back. Nothing is deleted.
- Leave. Leave sync on this computer stops syncing here. Your data stays on this computer, and your other devices keep theirs. It is also the way back when sync stopped. To sync again, the computer joins again.
The status mark
A status mark is always at the bottom of the sidebar. It tells you if you are backed up.
| The mark says | What it means |
|---|---|
| “✓ Synced 2 minutes ago” | The cloud has every change up to 2 minutes ago. |
| “3 changes waiting” | You are offline. 3 changes are only on this device. They upload when you are back online. |
| “Cloud Sync is off: your data is only on this computer” | You turned Cloud Sync off in the desktop app. Back up your folder yourself. |
| “2 collections are not in the cloud” | 2 collections are set to This device only. |
| “1.4 GB of files are only on this computer” | On Free, files over 200 MB stay on your device. Go Pro for 50 GB, or back up your folder. |
Click the mark to open a panel. It shows the last sync, what is in the cloud, and what is not and why.
What happens when…
| When… | What happens |
|---|---|
| Cloud Sync is off, and you install the phone app | A phone always uses Cloud Sync, because it has no folder. Your data is only on your computer, so the phone asks you to turn Cloud Sync on in the desktop app first. On Free, the phone is then a second device (next row). |
| You are on Free and sign in on a second device | The app says: “Free covers one device. Move to this device, or go Pro to use both.” Moving needs an Approve tap on the old device, or a 72-hour wait with an email and alerts you can cancel. Then your data comes from Cloud Sync to the new device. The old device keeps its copy read-only, with a Move back button. Files over 200 MB stay on the old device. |
| Your one Free device is a phone | That works. The phone keeps every file. It has no folder, only an optional read-only copy in the Files app. Cloud Sync stays on. |
| Your files pass 200 MB on Free | Files over 200 MB stay only on your device. The status mark says, for example, “1.4 GB of files are only on this computer”. Your data still syncs. Nothing is deleted. |
| You open another device, and a collection is This device only | It is not there. Not its name, not its entries. Only its own device shows it. |
| Someone gets into your email and signs in | They get none of your data at once. A new device needs an Approve tap on a device you have, or a 72-hour wait. We email you, and your devices show an alert, so you can cancel. |
| You lose a device, with Cloud Sync on | Sign in on a new device, approve it on another device or wait 72 hours, and Cloud Sync fills it. Remove the lost device in Settings → Devices. Lost with the device: This device only collections and entries, and on Free, files over 200 MB. |
| You lose a device, with Cloud Sync off | Your data was only on that computer. Install the desktop app on a new computer and use Restore from my folder with your own backup of ~/Kaizendex. With no backup, the data is gone. |
| You turn Cloud Sync off | Syncing stops at once. The cloud copy is deleted after 30 days; Delete now deletes it at once. On Pro with several devices, you pick the one device that keeps the data. The others delete their copy after a confirm that lists them. |
| You change a collection to This device only | A confirm lists your other devices. Then the collection’s cloud copy, and its copies on those devices, are deleted. |
| You set a shared collection to This device only | A shared collection must stay in Cloud Sync. A warning tells you that this stops the sharing. If you go on, the sharing stops. |
| You share an end-to-end collection (later) | Sharing turns end-to-end off for that collection. The app warns you first: “Sharing turns off end-to-end for this collection. We can read it, like any Cloud Sync collection.” The warning also lists the end-to-end entries inside it, which switch too. If you go on, the collection switches to plain Cloud Sync. This device only entries are never shared. When you stop sharing, you can turn end-to-end on again. |
| Two devices edit the same entry offline (Pro) | Each saves at once. Back online, the changes merge field by field. Text in a Block page merges word by word. If both change the same field, the later edit wins and the other stays in history. |
| A device that was away sends many deletes | They pause. Every device shows a card, such as “A device wants to delete 412 entries”, with Delete and Keep. Your own deletes in the app never pause: they have Undo. |
| Your folder is in a cloud drive too | When a change arrives through both the cloud drive and Cloud Sync, Cloud Sync wins and the drive’s copy is ignored. See Your folder. |
| An agent needs a This device only collection (Pro) | Agents in the cloud never see it. The agent runs on the desktop app while it is on, or it skips that collection and says so. |
| You use only a browser | Cloud Sync cannot be off. A browser can lose its data when it is cleared, so Cloud Sync is its backup. A collection set to This device only lives only in that browser, and clearing the browser deletes it. |
| Data arrives from a service on Free (sleep from Whoop) | It waits in the cloud until your device collects it. |
You use kzx or an AI tool on your computer |
kzx (our command-line tool) reads and writes through the desktop app. It works the same with Cloud Sync on or off, and with end-to-end on or off. Your privacy choices still apply: “No AI” collections are never given to AI tools, locked files stay locked, and Hidden stays hidden. |
| A cloud AI tool needs your data while your computer is off (later, Pro) | It connects to Cloud Sync. It reads plain Cloud Sync collections. It reads end-to-end collections only with a key you give that connection. This device only: never. |
| Pro ends | You pick one device that stays in Cloud Sync, under the Free limits: 200 MB of files and 30 collections. Your other devices keep their copy and keep working, but stop syncing. Nothing is deleted. If you have more than 30 collections, they all stay; you cannot add new ones until you are under 30. The rest of the cloud copy waits 90 days, then goes to cold storage, and is deleted one year after Pro ended, unless you come back. We email you a week before and on the day. |
| You forget every end-to-end key | You have no other signed-in device, no recovery words and no passkey that unlocks. The end-to-end cloud copy stays unreadable, by anyone, us too. In the desktop app, Restore from my folder makes a new key and uploads the data again. If you still have another device, it must approve the new key. The old cloud copy is kept 30 days before it is replaced. |
Inside Cloud Sync
For the curious, Cloud Sync has two parts inside:
- The cloud box (Pro). Your own small private database in the cloud, at Cloudflare, apart from everyone else’s. It passes your changes between your devices. It also runs your agents and automations while your devices are off. An agent there is a registered device with its own keys, so your Where settings apply to it too.
- File storage (R2), Cloudflare’s file storage. It holds your photos and files.
Free has no cloud box. On Free, Cloud Sync is a sealed copy of your data in file storage. It updates a few minutes after each change.
The full technical story is on How Cloud Sync works.