# How do I start work with Kai-Zen?

Checked 2026-11-15 against GilbApp d5296208bbffa2ab70076e6194f5537c4be1ddf7.

Press "Main menu", choose "Choose an agent", choose "Kai-Zen - Master Agent of Planning", type what you want, and press "Send".

## Before you start

You need to be [signed in to GilbApp](http://support.gilb.com/help/how-do-i-sign-in-to-gilbapp) on a computer, with your own AI, Claude Code or Grok, [connected in the chat](http://support.gilb.com/help/how-do-i-connect-my-ai-to-gilbapp-chat), each by its own answer. The pictures show a made-up person on a test site; your screen shows your own name and address.

## Steps

1. Press "Main menu" at the top left and choose "Choose an agent".

   Press "Main menu", next to your profile picture at the top left, and under "FOR YOU" choose "Choose an agent" \("Pick or connect an AI agent."\). GilbApp opens the left pane, where you chat, and puts the cursor on the agent list at the top of it.

   The button shows the name of the section you are in, such as "Vaults". The square button at the far left of the top bar also shows or hides the left pane. You can also search for "Choose an agent" in "Search or run a command".

   ![GilbApp with the "GO TO" panel open; "Choose an agent" under "FOR YOU" is outlined in orange.](http://support.gilb.com/help/media/11be94ad34f9404c.png)
   What you see: Top left, the button next to your profile picture is open, and the "GO TO" panel fills the screen. In the right column, under "FOR YOU", the last row "Choose an agent" \("Pick or connect an AI agent."\) has the orange outline. Click it.
2. Choose "Kai-Zen - Master Agent of Planning" in the agent list.

   Press the agent list at the top of the left pane and choose "Kai-Zen - Master Agent of Planning". Each agent has its own chat, and the list shows which one you are in.

   A new chat starts on the first agent in the list, "Jackfruit - Master Agent of Vaults and Information". The list comes from GilbPlatform each time the chat opens. GilbApp keeps your choice for this browser tab. While an agent is answering, the list is greyed out.

   ![GilbApp with the chat open in the left pane; the agent list at its top, showing "Jackfruit - Master Agent of Vaults and Information", is outlined in orange.](http://support.gilb.com/help/media/e4d179cc771756c3.png)
   What you see: The chat pane is now open on the left. At its top, the agent list has the orange outline; it still shows "Jackfruit - Master Agent of Vaults and Information", the first agent. To its right are "Claude Code" and "Disconnect". Click the list and pick "Kai-Zen - Master Agent of Planning".
3. Type what you want in "Write a message…" and press "Send".

   Click the box that shows "Write a message…" at the bottom of the left pane, type in your own words what you want to achieve, and press "Send".

   Return also sends; Shift and Return starts a new line. To the right of the agent list, your AI's name, "Claude Code" or "Grok", shows with "Disconnect" under it; "Connect" there means none is connected, and [connecting](http://support.gilb.com/help/how-do-i-connect-my-ai-to-gilbapp-chat) has its own answer. Kai-Zen first works out what you want: a new project, a project you already have, written requirements outside any project, or an idea to keep for later. Then it asks all its questions in one message; [answering them](http://support.gilb.com/help/how-do-i-answer-kai-zens-questions) has its own answer. While it works, the pane says "The agent is writing…", then "Ran" and the name of each tool it uses, and "Send" reads "Queue": a message you send then waits under "Waiting to send" until the agent is done, and "Slip in now" hands it to the agent at its next step.

   ![GilbApp with a message typed in the box at the bottom of the chat; "Send" to the right of it is outlined in orange.](http://support.gilb.com/help/media/e1950959a54460cc.png)
   What you see: The list at the top of the left pane now shows "Kai-Zen - Master Agent of Planning". At the bottom of the pane, a short request is typed in the message box, and "Send" to its right has the orange outline. Type what you want in your own words, then click "Send".

## Deeper

Kai-Zen asks only what only you know or may decide: your purpose, facts about you, money you will spend, and a change of direction. After your one reply it runs the work to the end. It still stops and asks you before some acts, such as putting work live, ending a record, deleting a vault or giving access to a vault. At the end it shows the whole result for one approval.

To skip the questions, write this in your first message, and Kai-Zen uses its defaults:
use your defaults

For a new project, Kai-Zen asks where to keep it and offers a new vault first; Jackfruit makes it. One vault holds one project.

Without your own AI, the chat answers only if GilbPlatform has switched on its shared AI; otherwise it says "Connect your own AI first — press Connect. Your AI works only for you."

GilbApp keeps your chat with Kai-Zen in this browser tab only, not in your vault. What lasts is what Kai-Zen saves where the project is kept.

In Claude Code in Terminal you can start Kai-Zen too, once [Claude Code is connected](http://support.gilb.com/help/how-do-i-connect-my-computer-to-my-vault) and [bound to its AI vault](http://support.gilb.com/help/how-do-i-make-an-ai-vault-and-connect-claude-code-to-it), each by its own answer. Start Claude Code, type this line with your own short name, the one you gave your AI when you connected your computer, and press Return:
/mcp\_\_gilb-&lt;short name\>\_\_agent
In a new Claude Code session it starts as Kai-Zen. Type what you want and press Return.

This answer is written for a computer screen.

Source: Kai-Zen \(K kai-zen-06gd2d286dz8s9b6ey63f9e49r\) steps Intent, Path, Delegate; Kai-Zen.Route.Evaluate \(idea, new project, existing project, specs outside any project\); Kai-Zen.AskRules \(K 06gdm7dyd5syda52jap5tm8qmm\) rules MustAsk, One \("If the requester said \\"don't ask\\" or \\"use your defaults\\", skip the round"\), Form, Stop \(release, cutover, live GilbVeda term, ending a record or deleting a vault, access, spend over Budget, human-set Value, standard\), EndApproval; Kai-Zen.ProjectRules.Vault \(K 06gdk6whjhwyq70fb176gdk4ew\). GilbApp 0c933e55 src/components/menu/sectionMenuList.ts:330-331 \("Choose an agent", "Pick or connect an AI agent."\), FOR YOU heading \(section-menu package, served bundle index-B3t\_MFSQ.js forYou:\`For you\`\), src/components/AppShell.tsx:1737-1744 and regions/LeftRegion.tsx:16-20 \(opens the left pane, focuses the agent list\), src/components/agent/AgentSelector.tsx:57-79 \(list, disabled while busy\), src/lib/base/chatAgents.ts:67-75 \(choice kept for the tab\), src/components/agent/AgentChat.tsx:4-5 \(thread stays in this tab\), :888 \("The agent is writing…"\), :1046 \("Write a message…"\), :1063 \("Queue"/"Send"\), :710-714 \(Return sends\), :762-765 \("Connect"\); production agent list https://gilb.com/base/ai/agents \(read 2026-11-09: picks Jackfruit, Kai-Zen, Agent.Concept, Agent.Coder with descriptions "Master Agent of Vaults and Information", "Master Agent of Planning", "Master of Concepts", "Master of Coding"; 19 entries pick:false\), drawn as \`Name - Description\` by src/components/agent/AgentSelector.tsx:15-16, :65-78; GilbPlatform 988605c5 src/routes/ai-chat.ts:229-235 \(no own AI and shared switch off: 403 ConnectYourOwnAI\); connector @kaigilb/gilbplatformcode-gilb-connector 0.5.12 \(GilbApp vendor .tgz, served https://gilb.com/app/gilb-connector.mjs\): src/connector.ts:33 \(DEFAULT\_AGENT = "Kai-Zen"\), :471-482 \(gilbplatform\_agent\), :543-553 \(prompt "agent", argument name\), README.md:72, :77; GilbApp 0c933e55 src/lib/base/gilbConnector.ts:74 \(server gilb-&lt;name\>\); Claude Code docs https://code.claude.com/docs/en/mcp "Use MCP prompts as commands" \(read 2026-11-09\). AgentChat.tsx:723-766 \(badge with "Disconnect" or "Connect"\), :954-1013 \("Waiting to send", "Slip in now"\); chatAgents.ts offeredAgent \(a new chat starts on the first pick\); ai-chat.ts:229-235 \(exact refusal text\).
