Skip to content

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.

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

The live database sits in your folder’s hidden .kaizendex folder; its backups and photo store sit in the app data, ~/.kaizendex/app-data in your home folder. The app writes your folder’s files from the database and reads your edits back. A linked browser reads and saves through the app and stores nothing. kzx and coding agents use the same database and folder.~/Kaizendex/.kaizendexthe live databasehidden, written by the enginebackups: ~/.kaizendex/app-data~/Kaizendexyour files, photos, chatsa read-only database copyyours to open and editA linked browserreads and saves through the appkzx and coding agentsthrough the same ruleswrites filesreads your edits
The database is the truth. Your folder is its mirror, kept in step both ways. A linked browser keeps no copy.
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.com and 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, open http://kaizendex.localhost:47321 instead.
  • 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 ~/Kaizendex folder. 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.
  • kzx works 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.