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
~/Kaizendexfolder; 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.