How automations work
An automation does work for you: when something happens, if a condition is true, it does a list of steps.
The three parts
| Part | What it is | Example |
|---|---|---|
| Trigger | What starts it. | A new workout is logged. Every Sunday at 20:00. |
| Conditions | When it may go ahead. Optional. | Only if Done is ticked and it is a weekday. |
| Steps | What it does, in order. | Add the tag Finished. Add 1 to Streak. |
There is only one kind of automation. There are no separate routines, rules or triggers to learn.
Two ways to write the steps
- Everyday actions are settings: “add the tag Finished”, “create an entry from the Weekly review preset”, “send me a notification”. The app reads them back to you as a sentence.
- Script steps are small programs in TypeScript (JavaScript with types). Use one when the everyday actions cannot say it: loops, sums, several collections, or an AI answer.
You can mix both in one automation, or write the whole automation as one script. Convert to script turns an automation made of everyday actions into the same thing as code. This works one way only. The old version stays in the automation’s history.
When you ask the AI for an automation, it picks the easiest way that can do the job.
An example
A habit rule, read back as a sentence on its page:
When Done becomes ticked in Habits → add the tag Finished → add 1 to Streak.
You tick “Meditate” for today. The tag and the new streak show in the same moment as the tick.
What an automation never does
An automation never deletes anything and never moves anything to the Trash. It never changes privacy, sharing, your plan or your settings. It never overwrites text you wrote: it can only add text to the end. The full list is in Actions.
Designs show, automations change
A card design can play an animation or show a toast when you tick a box. It cannot change other
data. Any change beyond one button’s own value is an automation. That way the change happens the
same way for every path: your tap, the AI, the kzx command line, or a notification button.
Where you find them
Each automation belongs to a collection and opens from it. The Automations list shows all of
them. Each automation has one page with the sentence, the steps, a Test button, the run history
and its versions. It is also a file in your folder, under Settings/Automations/.