The desktop app
The desktop app runs on Windows, macOS and Linux. It is the only app that keeps a two-way folder of your data and keeps working with its window closed. A browser on the same computer links to it and uses its data.
What works today
The first desktop app is built for Windows, and it builds for Linux too (a .deb package). It
runs on your own computer, with no account and no sync yet. Accounts and Cloud Sync come later.
| Works now | What it does |
|---|---|
| The engine inside the app | The app opens your database when it starts. Every tap goes through the engine: it checks the change, saves it and writes one log line. |
| Your folder | After the first paint, the app keeps your folder in step, both ways. See Your folder. |
| Tray icon | The tray menu has Open, Quick add, Pair a browser and Quit. |
| Close hides | Closing the window hides it to the tray. The app keeps running. Quit stops it. |
| One running copy | Open the app a second time, and the first window comes forward. |
| A browser on this computer | Pair a browser, and it uses the same data. See The browser and the desktop app. |
| AI with your own key | Chat with your own OpenRouter key, kept in this computer’s keychain. Add it in Settings → Plan & billing → Your OpenRouter key. The row shows the key as OpenRouter does, with a green check and “Connected to OpenRouter” when it works. See Choose your AI. |
| Works offline | The fonts ship inside the app. No screen waits for the web. |
| Quick add | Press Ctrl+Alt+K (⌘⌥K on a Mac) in any app. A small box opens over it, like the quick entry of the Claude and ChatGPT apps. Type, press Enter, and your AI logs it in the app. Esc closes the box. Turn it off in Settings → Devices. |
| Start with the computer | On by default. The app starts in the tray when you sign in to the computer, with no window. Turn it off in Settings → Devices. |
kaizendex:// links |
A link opens one page straight in the app. See the table below. |
| Notifications | A new message from your AI, and new trouble with your folder, show as a computer notification while the window is not in front. Settings → Notifications turns them off. |
| Settings → Devices | Lists the browsers paired with this computer, with when each was last used. Remove unpairs one at once. |
| The fresh unlock | A paired browser shows no locked or Hidden items until you unlock them there with Windows Hello (or your computer password on Linux). Locked means any AI choice but Any AI. The unlock lasts 15 minutes. |
Quit stops the folder sync first, then closes the database. So nothing stops halfway.
Not built yet: the Mac build, local AI apps, and the fresh unlock for end-to-end collections (it comes with that feature).
Settings while there is no account
Settings shows only what is true for an app with no account:
| Section | What it shows |
|---|---|
| Plan & billing | Your OpenRouter key and search by meaning. No plan and no payment: you have every feature. |
| Security | Warn before opening external links. No sign-in rows. |
| Data sync | “Saved on this computer”, and the export. Nothing syncs to other devices. |
| Plugins | Google Health. |
| AI usage | Last 30 days draws a bar a day; All time draws a bar a month. |
| Trash, Files & media | Open in Settings, over the page you had open. The page stays as it was. |
Settings has no Account section yet. It comes with accounts.
kaizendex:// links
| Link | What opens |
|---|---|
kaizendex://entry/<id> |
that entry |
kaizendex://collections/<id> |
that collection |
kaizendex://chat/<id> |
that chat |
kaizendex://settings/<section> |
that Settings page, such as kaizendex://settings/devices |
kaizendex://quick-add |
the quick-add box |
kaizendex://open |
the app window |
kaizendex://browser |
the app in your browser, through the desktop link |
If the app is not running, the link starts it. If it is running, the open copy gets the link. A link with anything else in it opens nothing.
Settings → Devices
| Row | What it does |
|---|---|
| Start with the computer | The checkbox for start at login. On by default. |
| Quick add | The checkbox for the Ctrl+Alt+K box. If another app already uses those keys, the row says so. |
| Paired browsers | Each browser on this computer that uses the app: its name, when it was last used, and until when it shows locked items. Lock hides them there again. Remove unpairs it. Pair a browser shows a new code. |
In a paired browser, the same page has This browser: Unlock for locked items (Windows Hello pops up on the computer), Lock, and Forget this browser.
Where its data is today
| What | Where |
|---|---|
| Your folder | the name and place you chose on the first start, ~/Kaizendex by default |
| The database and search vectors | your folder’s hidden .kaizendex folder: main.sqlite, locked.sqlite, vectors.sqlite (on a cloud or network drive: ~/.kaizendex/app-data) |
| The photo store | ~/.kaizendex/app-data/Attachments (your folder’s Attachments are the same files) |
| The backups | ~/.kaizendex/app-data/backups |
| Paired browsers | ~/.kaizendex/app-data/link/browsers.json, as fingerprints of their secrets only |
| Window settings and the start log | ~/.kaizendex/app-data/desktop.json and ~/.kaizendex/app-data/logs/start.log |
| Where your folder is | ~/.kaizendex/location.json |
| Your OpenRouter key, the key for locked items | the Windows keychain (Credential Manager), under “Kaizendex v2” |
Settings → Your data shows each place, with its size and Show in Explorer, and moves the database into your folder. See Where your data lives.
Three settings move these places, for tests: KZ_DATA_DIR sets the database’s folder,
KZ_FOLDER your folder, and KZ_LOCATION_FILE the note that says where your folder is. The app
and kzx all read them.
What only the desktop app does
| Feature | What you get |
|---|---|
| Your folder | ~/Kaizendex: one folder per collection, one markdown file per entry. Edit a file in any editor and the app takes the change in. Want it as a copy only? Select Read-only folder in Settings → Folder. Only the desktop app keeps this folder. |
| The browser link | A browser on this computer shows the app that the desktop app serves, from its own signed code. It stores nothing of its own. |
| Local only (later, with Cloud Sync) | Turn Cloud Sync off, so your data is only on this computer. Only the desktop app can do this. |
| Restore from my folder (later) | Rebuild your data from a ~/Kaizendex folder, into any account. It only adds and updates entries; it never deletes one. |
| Tray or menu-bar icon | Kaizendex stays one click away. |
| Quick-add hotkey | Ctrl+Alt+K (⌘⌥K on a Mac) works in any app, to log something fast. |
| Start at login | On by default. It starts with your computer and runs with the window closed, so reminders and automations still run. |
| One running copy | Opening it again brings the open window forward. |
kaizendex:// links |
A link that opens one entry or one screen straight in the app. |
| Local AI apps (later) | Use Ollama or LM Studio on your computer as your AI. Nothing leaves the computer. |
| Coding agents | Claude Code, Codex and others work through your folder, kzx or MCP. |
| Unlock with your body | Locked and Hidden items open in a paired browser with Windows Hello, or your computer password on Linux. End-to-end collections follow (later). |
Where things are kept
| What | Where |
|---|---|
| Your folder and the live database | ~/Kaizendex by default, the database in its hidden .kaizendex folder; you choose the place on the first start |
| The photo store, the backups (and the database, when your folder is on a cloud or network drive) | the app data, ~/.kaizendex/app-data, the same on every system. In your home folder, not in %APPDATA%: Windows gives programs started from a Store app such as Claude Desktop their own copy of %APPDATA%, and deletes it with that app. An account made before this keeps them in %APPDATA%\Kaizendex until you move them. |
| Sign-in tokens, API keys, the key for locked files | your computer’s keychain, never the folder |
Your database is protected by your computer login and disk encryption (BitLocker on Windows, FileVault on a Mac). The app checks whether disk encryption is on, and recommends it. See How your data is protected.
Your browser uses it too
When the desktop app is on your computer, a browser there links to it. The desktop app
serves the app to the browser itself, at a local address on this computer, from the signed code
inside the desktop app. The browser reads and saves through the desktop app, so there is one
database and one ~/Kaizendex folder on your computer. The browser stores nothing of its own,
so clearing it loses nothing.
- Pairing: open
app.kaizendex.comand pick Open through the desktop app. The desktop app shows a short code. Enter it in the browser. That browser gets its own secret. Today, before the web app is online, openhttp://kaizendex.localhost:47321instead. - Paired browsers: Settings → Devices lists them. Remove unpairs one.
- Private things need a fresh unlock. Locked and Hidden entries and collections ask for Windows Hello (or your computer password on Linux) before the browser shows them. End-to-end collections will ask the same (later).
- When the desktop app is closed, the browser shows Open the desktop app. Turn on Start at login so the app is almost always running, in the tray.
Example: you add “Morning run” in Chrome. Morning run.md appears in ~/Kaizendex within
seconds, offline too.
More: The web app and The browser and the desktop app.
Cloud Sync on or off
Cloud Sync is on by default. It keeps a copy of your data in the cloud: it is your backup, and on Pro it keeps all your devices the same. The desktop app is the only app that can turn it off, in Settings → Cloud Sync.
- Turning it off stops syncing at once. Your data is then only on this computer, in its
database and your
~/Kaizendexfolder. Back up the folder yourself, with Time Machine (Mac) or File History (Windows). - Turning it off is a change only you can make. The app asks for a fresh check first (Face ID, a fingerprint, Windows Hello or your computer password).
- The cloud copy is deleted after 30 days, so a mistake can be undone. 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.
- Turning it on again uploads your data.
kzxworks the same with Cloud Sync on or off: it reads and writes through the desktop app’s engine.
The status mark at the bottom of the sidebar always says where you stand, such as “✓ Synced 2 minutes ago” or “Cloud Sync is off: your data is only on this computer”.
Small and light
The app is built on Tauri. It uses the web engine your computer already has, so the download is a few MB, not around 100 MB. Updates install themselves.
On Free
On Free, Cloud Sync covers one device. The desktop app and a browser linked to it on the same computer are one device, so on Free you can use both. A browser on another computer, or a phone, is a second device.
Example: you get a new laptop and sign in there. The app says: “Free covers one device. Move to this device, or go Pro to use both.” You tap Approve on the old laptop, or wait 72 hours if you no longer have it. Then your data comes from Cloud Sync to the new laptop. The old laptop keeps its copy, read-only, with Move back. See Sign-in and keys.