Skip to content

How automations work

An automation does work for you: when something happens, if a condition is true, it does a list of steps.

An automation has three parts in a row: a trigger, conditions, and steps. The steps are everyday actions or a script.1 · TriggerDone becomes tickedin Habits2 · Conditionsonly on weekdaysoptional3 · Stepsadd tag Finishedadd 1 to Streakeverydayscript
Every automation has the same three parts. Steps are everyday actions, a script, or both.

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