Use Kaizendex with Claude Code or Codex
At the end Claude Code (or Codex) answers questions about your data and adds tasks for you, and every change it makes shows in the app, checked and undoable.
You need: the desktop app, so your data has a folder on your computer (by default
~/Kaizendex). See Your folder.
-
Open Claude Code (or Codex) in your Kaizendex folder. The folder’s
AGENTS.mdtells the agent where everything is and which door to use for which job. -
Ask: “What is overdue in each project?” The agent can answer in one call with
kzx context, or with one SQL query on the read-only copy. See kzx commands. -
Ask: “Make three tasks for Spring training plan: buy gels, plan the long run, book a massage.” The agent writes three files in
Collections/Tasks/, each withparent: [[Projects/Spring training plan]]. Each collection’s_schema.mdtells it which fields to fill. -
Look in the app. The three tasks are in Tasks and inside the project at once.
-
Open the history. Each change says “Claude Code, via the folder”. Undo any of them like a change you made.
-
If an edit could not be taken in (a wrong tag, a broken line), it is listed in
.kaizendex/problems.mdand bykzx status. Nothing is dropped.
A task file looks like this:
---title: Buy gelsdue: 2026-11-03parent: [[Projects/Spring training plan]]---Get 6 for the long runs.What the agent cannot change. The agent can only suggest a change to where a collection
lives, its AI setting, sharing or keys. If Claude Code edits a _collection.json to do that, the
app shows “This change needs your OK in the app” and keeps the old value until you approve it.
When the agent asks to read a collection set to Ask me first, the app names it: “An MCP client calling
itself “claude-code” wants to read Diary”. See Changes only you can make.
No shell? Agents such as the Claude desktop app use the MCP server instead. It has
the same tools as kzx. See MCP tools.
Make it yours
- Turn on “Version this folder with Git” to keep your text files in a Git history too.
- Drop a batch of entries into
_inbox/. The app shows what will change, and you apply it as one undoable step. See When you or an AI edit the folder. - Keep your coding skills in Kaizendex. See Use one skill in every coding project.