Skip to content

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.

A coding agent has three doors: the files, the read-only database copy, and kzx or MCP. Writes through the files and kzx go into the live database through the app’s rules.Claude Codeor CodexFiles: read and editCollections/Tasks/…kaizendex.sqliteread onlykzx or MCPsearch, context, safe writesLive databasechecked, logged
Read with SQL; write with files or kzx. The database copy is never written.
  1. Open Claude Code (or Codex) in your Kaizendex folder. The folder’s AGENTS.md tells the agent where everything is and which door to use for which job.

  2. 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.

  3. 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 with parent: [[Projects/Spring training plan]]. Each collection’s _schema.md tells it which fields to fill.

  4. Look in the app. The three tasks are in Tasks and inside the project at once.

  5. Open the history. Each change says “Claude Code, via the folder”. Undo any of them like a change you made.

  6. If an edit could not be taken in (a wrong tag, a broken line), it is listed in .kaizendex/problems.md and by kzx status. Nothing is dropped.

A task file looks like this:

---
title: Buy gels
due: 2026-11-03
parent: [[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