← Back to Can I make a mobile app for iPhone or Android?
How do I start work with Kai-Zen?
Short answer
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 on a computer, with your own AI, Claude Code or Grok, connected in the 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.
Words used here (6)
- agent
- An agent is your AI following one written procedure, its standing instructions, for one kind of work.
- Kai-Zen
- Kai-Zen is the planning agent: it finds out what you want, chooses the way, hands the work to other agents and reports back.
- GilbApp
- GilbApp is the app, opened in a web browser at https://gilb.com/app, where you open, fill and share your vaults.
- Jackfruit
- Jackfruit is the vault agent: it finds, reads, writes and links records in your vaults, and makes new vaults for you.
- GilbPlatform
- GilbPlatform is the service that keeps people's and organisations' data in vaults, each at its own web address.
- project
- A project is work to bring about a change you want, such as a new app or a better way of doing something.
Steps
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.


Show as text
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.
More about this
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.
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.


Show as text
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".
More about this
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.
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.


Show as text
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".
More about this
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 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 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.
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 and bound to its AI vault, 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-<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-<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).
Checked against GilbApp d529620.