Skip to content

Settings

Settings live in three places: the Settings pages for your whole account, the Share & privacy panel on each collection and entry, and, with the desktop app, the Settings/ folder on your computer. Collections and hubs also have their own settings.

The Settings pages

To open Settings, click your account in the top-left corner of the window (“Daniel’s Kaizendex”). Settings opens at once, at its first section. The button has no menu. See Find your way around.

Page What you set there
Where your data lives your devices, your folder (desktop) and your cloud copy, in one overview
Cloud Sync the Cloud Sync checkbox (on by default; only the desktop app can turn it off); the starting Where it lives for new collections; what is in the cloud and what is not; Delete now for the cloud copy after you turn Cloud Sync off
Devices every signed-in device and browser, and every browser paired with the desktop app; add a device (it needs Approve on a device you have, or a 72-hour wait), remove one; Sign out everywhere; on Free, Move to this device and Move back
Folder (desktop) open or change your folder; Read-only folder; backups, Go back in time, Restore from my folder; “Fix these” for edits the app could not apply; and the limit of locked files said in one line
Privacy starting values for new collections only (what AI may read, and the rest)
Security AI permissions: what an AI may do, one checkbox each (see below); your sign-in methods and passkeys; the recovery code (16 digits, for an account with no email); with end-to-end on, your 12 recovery words, the printable Recovery Kit and your ways to unlock end-to-end data (the app warns if only one is left); the PIN for Hidden items; Support access: allow it for a set time (24 hours by default) and only for what you choose; it shows in your log and ends by itself
Plan & billing your plan, AI credits, usage, the card (through Stripe); after Pro ends, which device stays in Cloud Sync; Your OpenRouter key (desktop): the saved key as OpenRouter shows it (sk-or-v1-f33••••••••••••••••4cc6), a green check and “Connected to OpenRouter” or a red line when OpenRouter refuses it, Replace and Remove
Your data (desktop, under Storage) where every part of your data lives: your folder, the database, the backups and the app data, each with its size and Show in Explorer; Change… moves your folder. See Where your data lives
Storage the small copies of your pictures on this device and their Total (the rows added up); in the desktop app, how much space your data takes on this computer, where your folder is, and Show in Explorer (no plan limit); online: files used of 200 MB (Free) or 50 GB (Pro), the largest files by collection, the +100 GB add-on (Pro)
Appearance your theme, every design and where it applies, Effects (each moment, such as the tick confetti), “What changed” after an update, “What is slow?”
AI which AI handles each job (chat, speech-to-text, search): your own OpenRouter key (saved in Plan & billing), or Kaizendex AI with credits; Safety, with the presets Standard, Strict and Custom
Agent home (Pro, later) schedules, approvals, run history, the off switch; Channels (Telegram, WhatsApp); Browser (Research mode, sites for Acting mode)
Sync on this phone (phone, later) Use mobile data for: Nothing · Text only · Everything; the file cache size (2 GB by default)
Help and Docs (under About) a link to these Docs, and the address to write to us

Settings → Devices

  • Every signed-in device and browser is listed, with when it was last used.
  • This computer (desktop app): Start with the computer, a checkbox, on by default: the desktop app starts when you log in and sits in the tray (the menu bar on Mac). Quick add, a checkbox, on by default: Ctrl+Alt+K opens a small box over any app.
  • Paired browsers are the browsers on this computer that use the desktop app’s data. Each paired once with a short code. Remove unpairs one. Lock hides Hidden items in it again.
  • This browser (a paired browser): Unlock shows Hidden items there for 15 minutes, after Windows Hello on the computer. Forget this browser unpairs it.
  • Sign out everywhere signs out every device except the one in your hand.
  • A new device needs an Approve tap on a device you already have. With no other device, it waits 72 hours, with an email and an alert on every device, and you can cancel. See Sign-in and keys.
  • What skips the wait: a passkey bound to one device (a security key, or a passkey saved only on one device), or your recovery words, if you turned on end-to-end. A passkey synced by Apple or Google does not skip it: it is only as safe as your Apple or Google account. See What skips the wait.
  • No email on the account? After you lose its passkey and every device, the 16-digit recovery code starts the 72-hour wait. It works once; then the app makes a new one.

Settings → Folder

In the desktop app only. From top to bottom:

  • Your folder: where it is (Show the folder opens it), its status, and which cloud drive holds it, if one does.
  • Read-only folder is a checkbox, off by default. With it on, Kaizendex keeps writing your folder, but it ignores edits made in it. See When you or an AI edit the folder.
  • Deletes waiting shows when many entry files went missing at once: Delete moves those entries to the Trash, Keep writes their files back.
  • Fix these lists edits the app could not apply, and conflicts where you pick a version.
  • Last import names the last file from your inbox or kzx import, with Undo.
  • Collections: each collection’s folder choice (In the folder, Database only, Not in the folder), the same as in its Share panel.
  • Go back in time lists the app’s backups, newest first. Go back… asks: everything or one collection. It says what would change, then goes back as one step with Undo. Going back and Restore from my folder only add and update entries. They never delete one. See Backups, export and recovery.

Settings → AI → Safety

Safety decides what your AI may do without asking you first. It has three presets:

Preset What it is
Standard (the default) The AI asks before it sends, posts, pays or deletes anything outside the app. A changed outside tool waits for your OK. Agents have a daily spending limit. And more.
Strict Standard, plus: after the AI reads an outside page, a new web address it makes up needs your OK; a reader AI with no tools reads outside pages first; an approved automation’s destination (an email address, a website) stays fixed.
Custom You tick or untick each rule yourself, every rule included, such as a checker AI that approves the safe actions for you (off in Standard and Strict).

The rules are ordinary rules in the house JSON language, so you can read, change, copy and share them like any block. Changing Safety is a change only you can make: an AI can never loosen its own rules. Every rule, one by one, is on AI safety settings.

Settings → Security → AI permissions

AI permissions say what an AI may do beyond reading and writing your entries. One checkbox per power. Each one is off by default.

Checkbox When it is ticked
AI can make and switch on automations an AI (an agent in a chat, kzx, MCP apps such as Claude Code) makes, changes, switches on and off, and deletes automations; they run with no Approve card. An automation an AI made keeps the AI’s limits until you switch it on yourself
AI can move collections to the Trash an AI moves a whole collection and its entries to the Trash. Undo or the Trash brings it back. Never a collection closed to AI. Delete for good stays yours

Only you tick a permission: it is a change only you can make, and an AI can never read or change it. When a permission stops an AI, the answer links to the checkbox: kaizendex://settings/security/ai-automations (or …/ai-collections) opens the desktop app on Settings → Security, scrolls to the row and highlights it for a moment. In a chat, a card “Kaizendex needs your permission” has the button “Open AI permissions”, which does the same. See AI safety settings.

Changes only you can make

Some settings need you, in the app, after Face ID, a fingerprint, Windows Hello or your device password: Where, turning Cloud Sync off, AI, AI Safety, AI permissions, Hidden, sharing and publishing, approving scripts, automations and HTML blocks that run a script, giving an agent a key, devices, paired browsers, sign-in methods, recovery, Delete for good and deleting your account. The folder, kzx, MCP and agents can only suggest them. One exception is yours to allow: with “AI can make and switch on automations” ticked, an AI makes and switches on automations itself; with “AI can move collections to the Trash” ticked, it moves collections to the Trash. See Changes only you can make.

Settings → Cloud Sync

  • The Cloud Sync checkbox is on by default. Only the desktop app shows it: a browser on its own and a phone always use 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 (Time Machine, File History). 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.
  • Where new collections live: the starting value of Where it lives for each new collection.

On each collection and entry

The Share & privacy button, at the top right of every collection and entry, opens one panel:

Choice Values
Who can see it Only me · People · Anyone with the link · Public
Where it lives Cloud Sync · Cloud Sync, end-to-end encrypted (later) · This device only
AI Any AI · Ask me first · Only my local AI · No AI
Hidden No · Yes
In the folder (collections) In the folder · Database only · Not in the folder

An entry follows its collection until you change it there; then the entry’s choice wins.

Where it lives has three values:

Value What it means
Cloud Sync (the default) on your devices and in the cloud. Kaizendex protects it and can help you recover it.
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 is not on your other devices or in the cloud.

Example: your Diary collection is end-to-end encrypted, your Work notes are This device only, and Workouts uses plain Cloud Sync. See End-to-end encryption.

Changing a collection to This device only deletes its cloud copy and its copies on your other devices, after a confirm that lists the devices. A shared collection must stay in Cloud Sync: making it This device only stops the sharing, after a warning. Sharing an end-to-end collection turns end-to-end off for it, after a warning too.

The status mark

At the bottom of the sidebar, the status mark always says whether your data is safe in the cloud:

It says What it means
“✓ Synced 2 minutes ago” everything is in Cloud Sync
“3 changes waiting” you are offline; they upload when you are back
“Cloud Sync is off: your data is only on this computer” local only, in the desktop app
“2 collections are not in the cloud” they are This device only
“1.4 GB of files are only on this computer” on Free, files over 200 MB

Click it to open a panel: the last sync, what is in the cloud, and what is not and why.

On each collection

Each collection also has its own settings for its properties, views, card designs and AI instructions (for example “in Workouts, always log weight in kg”). These settings decide how the app talks about its entries, how they show in tabs and blocks, and how the collection shows in the sidebar:

Setting What it does Default
One entry is called the word for one entry, used in buttons, menus, toasts, empty states, search filters and the AI’s replies: “New workout”, “Workout moved to Trash · deleted for good after 30 days” the collection’s name plus “entry”: “Workouts entry”
Several are called the word for many entries: “No workouts yet”, “Move 3 workouts to…” the collection’s name plus “entries”: “Workouts entries”
Show in a tab what one entry shows in a new tab: one property · the whole entry page see the table below
Show in a block what one entry shows in a new Entry block: a link · its card · one property see the table below
Show in the sidebar the collection has a row in the sidebar’s Collections until you choose that list yourself; the row is one button that opens the collection page and never lists its entries on for Notes and Dashboards, off for the rest
Name and icon what the collection is called, its icon, and what shows: icon and name · icon only · name only icon and name

The defaults we set for Show in a tab and Show in a block:

Collection In a tab In a block
Dashboards its Dashboard property its Dashboard property
Notes the whole note (its entry page) a link
Every other collection the whole entry page its card

Each tab and each block can still pick its own Show. One that never picked follows this default, so changing the default changes it too. See How its entries show.

  • When you type your own word for one entry (“workout”), the app suggests the word for several (“workouts”). You can change it.
  • Notes start as note / notes and Dashboards as dashboard / dashboards. Library starters bring their own words (Workouts: workout / workouts).
  • These words never change your data. Titles and file names stay as they are.
  • The tree shows the collection’s entries that have no parent, with everything inside them (by Parent, from any collection).

On each tab bar

Every tab bar (of a collection, a global collection or a hub) has a + at its end. The quick options sit at the top of its menu. Edit this menu… changes them for that one tab bar.

Tab bar Quick options we set up
A hub New dashboard · New view · New global view
A collection (Workouts) New view (of Workouts) · New dashboard
A global collection New view (of it) · New dashboard

A quick option is “a new entry in a collection” (with a label and an icon), “a new view” or “a new global view”. So you can add your own, such as New note. If you delete a collection, its quick options go away from every menu.

On each hub

Setting What it does
Name and icon what the hub is called, its icon, and what shows: icon and name · icon only · name only
Tabs which tabs it has and their order; each tab points to an entry or holds a view
Quick options the choices at the top of its + menu

A tab takes its name and icon from what it shows, unless you give it its own. Deleting a hub, or removing a tab, never deletes an entry. A deleted hub waits 30 days in the Trash.

You can share a hub in two ways:

Way What goes out
Share with a person your real hub, every tab, with your data. The collections and entries the tabs show join the share. The app lists them first.
Publish to the Library a setup only, never an entry of yours. Its view tabs and quick options come along; a dashboard tab goes as its layout (a preset of Dashboards); other entry tabs stay behind. The app lists what goes out and what stays behind.

See Share a hub.

On each entry tab

Setting What it does
Show what the tab shows of its entry: one property (for example the “Dashboard” property) · the whole entry page. It starts with the collection’s Show in a tab.
Name and icon the tab’s own name and icon. Renaming a tab renames only the tab, never the entry.

The tab’s menu also has Open dashboard (or Open note, Open workout: the word comes from what one entry is called). It opens the entry’s own entry page.

An Entry block has the same kind of setting: Show (a link · its card · one property). It starts with the collection’s Show in a block. See Blocks and charts.

In your folder

With the desktop app, your settings are also files in ~/Kaizendex/Settings/. You or an AI can edit them; the app checks every change. A file edit to a protected change, such as an AI choice or an automation’s powers, waits for your OK in the app: “This change needs your OK in the app”. A browser never writes this folder: a linked browser uses the desktop app’s settings, and a browser without the desktop app keeps them in its own storage (Export puts them in the ZIP).

File or folder Holds
sidebar.json the five sections of the sidebar (Views, Hubs, Chats, Favorites, Collections): their order, the hidden ones and the rows you removed
Hubs/ one file per hub, such as Hubs/Home.json
theme.json your theme
settings.json your other settings, one line each: the time format, the chat model, the calendar’s default collection, and the rest
Design/ your designs, as .json, .html, .css and .ts files
Automations/ your automations

Keys and passwords are never in the folder. They stay in your computer’s keychain.