Which app to use
On a computer, use the desktop app: it keeps your data in your own folder and works offline. You can still work in Chrome: on the same computer, the browser links to the desktop app. The browser alone also works, with limits. The phone apps come last.
The apps side by side
The web app works in two ways. Linked: on a computer with the desktop app, it uses the desktop app’s data. Browser only: on a computer without it, it keeps its own copy.
| Desktop app | Web app, linked | Web app, browser only | Phone apps (later) | |
|---|---|---|---|---|
| Where your data is | its database, mirrored as files in ~/Kaizendex |
in the desktop app; nothing in the browser | the browser’s private storage | the phone’s own copy |
| Your folder of files | yes, two-way | the desktop app’s folder | none; export a ZIP | none; an optional read-only copy in the Files app |
| Cloud Sync | on by default; the only app that can turn it off | the desktop app’s setting | always on | always on |
| Works offline | yes | yes, while the desktop app runs | yes | yes |
| Clearing the browser | — | loses nothing | deletes changes that exist only in this browser | — |
| Unused for weeks | safe | safe | Safari deletes site data after 7 days; Cloud Sync brings it back | safe |
| A device of its own (Free) | yes | no: it is part of the desktop app | yes | yes |
| Local AI apps, Claude Code, Codex | yes | through the desktop app | through a desktop app only | no |
| GPS runs, Apple Health, home-screen widgets | no | no | no | yes |
| Keeps working with the window closed | yes | the desktop app does | no | limited by the phone |
The full list is in What each app can do.
Why the desktop app comes first
- Your own folder. Only the desktop app makes and writes
~/Kaizendex: your entries as markdown files, and your photos and files as real files. A browser never writes a folder. - Offline safety. Your data is on your disk, not in browser storage that the browser or you can clear.
- Local only. Only the desktop app can turn Cloud Sync off. See below.
- The most features: local AI apps, coding agents, and automations that run while the window is closed.
Why Chrome comes first among browsers
Chrome (and the browsers built on its engine: Edge, Brave, Arc, Opera) is where we build, test and measure the web app. Safari and Firefox are tested before launch, but they never hold the work back.
The browser on a computer with the desktop app
The browser links to the desktop app by default. You pair a browser once: the desktop app shows a short code, and you confirm it in the browser. That browser then gets its own secret, which it needs for every request. Only this computer can reach the link.
- An entry you make in the browser lands in the desktop app’s database. Its file appears in
~/Kaizendexwithin seconds, offline too. - Only the desktop app writes your data and your folder, so nothing collides.
- The desktop app is closed? The browser shows one button: Open the desktop app. Set the desktop app to start with the computer, and it is usually running.
See The browser and the desktop app.
The browser alone
On a computer without the desktop app, the browser keeps its own copy in its private storage. It works, with limits:
- The app asks the browser for persistent storage, so the browser does not delete your data on its own. You can still clear it yourself.
- A counter shows changes that exist only in this browser, with Get the desktop app and Export.
- Safari deletes a site’s data after 7 days without a visit. The app tells you.
- Export makes a ZIP of everything, on every browser.
- Cloud Sync is always on in a browser on its own, so clearing the browser loses only the changes not yet in the cloud. On Free, the cloud copy updates a few minutes after each change.
See Offline and clearing your browser.
Local only: the desktop app
Want nothing in the cloud? Use the desktop app and turn Cloud Sync off in Settings → Cloud
Sync. Then your data lives only on that computer, in its database and your ~/Kaizendex
folder. Back up the folder yourself, with Time Machine (Mac) or File History (Windows).
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. You can still make one collection or one entry This device only, such as a Diary collection on your laptop.
On Free: one device
On Free, Cloud Sync covers one device. A browser linked to the desktop app is not a device of its own, so on Free you can use both the desktop app and the browser on one computer. A browser on a computer without the desktop app is a device of its own, and so is a phone.
Sign in on a second device, and the app says: “Free covers one device. Move to this device, or go Pro to use both.” Moving needs an Approve on the old device, or a 72-hour wait. It brings your data from Cloud Sync to the new device. The old device keeps its copy, read-only, with Move back.
A phone can be your one device. On Free it keeps every file. It has no folder, and Cloud Sync stays on. Pro syncs all your devices. See Free and Pro.