Agents
An agent is an AI helper you set up for one job, such as a running coach. Each agent is an entry in an ordinary collection, so you see, search, edit, undo and share it like any other entry.
What an agent is made of
| Part | Example for “Coach” |
|---|---|
| Name and icon | Coach 🏃 |
| Instructions (its persona: who it is and how it talks) | “You are my running coach. Keep answers short. Log runs in km.” |
| Model | which AI writes its answers: Kaizendex AI, your own OpenRouter key, or a local model |
| Skills | reusable instructions it may use, such as weekly-review |
| Tools | what it can do: search entries, add an entry, read a web page |
| Approval rules | which actions wait for your Approve tap |
Every field, with its options, is on Agent settings.
Rules every agent follows
- Your privacy choices win. An agent cannot read a “No AI” collection, even if its instructions ask it to.
- Outside changes go through the outbox. The outbox records every one. By default, sending, posting, paying or deleting outside the app waits for your Approve tap, unless it is part of an automation you approved.
- A daily spending limit. By default, agents stop for the day when they reach a spending limit.
- Your AI safety settings apply to every agent. Standard is the default; Strict adds more checks. See AI safety settings.
- Some changes only you can make. An agent cannot change where a collection lives, its AI choices, sharing, keys or your AI safety settings. It can only suggest the change, and the suggestion waits in the app for your OK. See Changes only you can make.
- Every change it makes to your data is logged with its name (“Coach, in a chat”), and you can undo it.
Agents are entries
Agents, memory facts, About me and skills all live in ordinary collections. So an agent gets everything an entry has:
- History and undo for every edit to its instructions.
- The Trash: a deleted agent stays 30 days, then it is gone for good.
- A file in your folder, so Claude Code can read or edit it too.
- Sharing through the Library. You can publish an agent on purpose, one at a time; others get their own copy. See Share agents and skills.
Where an agent runs
| Plan | Where your agents run |
|---|---|
| Free | on your one device, while it is on. Free has Cloud Sync, but no agents in the cloud. |
| Pro | on your devices, and in the cloud while every device is off: the agent home, part of Cloud Sync. It comes after the first release. |
| Cloud Sync off (desktop app only) | on the desktop, while it is on |
How agents in the cloud are built, and why stronger agents can plug in later: How agents in the cloud work (technical).