A scheduled workflow is a workflow that your agent runs on its own, at the times its schedule gives. A starter waits for you to type its name. A scheduled workflow runs every Monday at 08:00, whether you are there or not.

Kater keeps the workflow and its schedule. Your own agent runs it: a scheduled task in Claude Cowork, an automation in Codex, or an Automation in Cursor.

Starters and scheduled workflows

Kater ships one: Monday Brief, which briefs you every Monday at 08:00 on what moved last week in the metrics you watch. It writes the brief as a page in Kater, laid out by the brief template.

Ask your agent to schedule it

Run the Schedule a workflow starter, such as /schedule-workflow monday-brief, or ask in your own words: “Schedule my Monday brief for 9am.”

Your agent changes the workflow in Kater first, then the task in its scheduler. When it can set up its own scheduled tasks, such as with /schedule in Claude Cowork, it sets up the task itself after your yes. When it cannot, or when the task is in another agent, it gives you the prompt and tells you the one setting to change there.

Change a scheduled workflow

Ask your agent, for example “add ROAS to my Monday brief” or “move my Monday brief to 9”. What changes depends on what you change:

A shared workflow, such as Monday Brief, is the data team’s. To run it at another time or with other steps, your agent writes a workflow of your own that follows the shared one, with its own schedule.

When the schedule in Kater changes and the task does not, the next run says so first in its answer, so you can change the task to match.

Schedule it yourself

The prompt says when the workflow runs and which file to follow. Your agent reads that file again at each run, so a change to the steps reaches the next run without a new prompt.

Run my Kater workflow "Monday Brief" on a schedule.

---

Schedule: Every Monday at 08:00, in my own time zone (cron 0 8 * * 1).
At each run, read connections/<connection>/ai_tools/workflows/monday-brief/workflow.md with the Kater tools and follow it. Do not stop to ask me questions during a run.
If the schedule in that file is no longer the one above, say so first in your answer, so that the task can be changed to match.

Make your own

• Let your agent write it. Run the Weekly digest or Watch a metric starter. Your agent drafts the digest or the check with you. After your yes, it writes a scheduled workflow in your own ai_tools/workflows/ folder and schedules it.
• Write it yourself. On AI Tools › Workflows, select New, give it a name, and select Create. Kater makes the file in your own folder. In Edit, add a schedule: block to its frontmatter and write the steps it follows.

1
---
2
label: Paid media Monday
3
name: paid-media-monday
4
description: Every Monday, brief me on paid media spend and return by platform for the last full week.
5
schedule:
6
  cron: "0 8 * * 1"
7
  timezone: America/Los_Angeles
8
---
9

10
# Paid media Monday
11

12
1. Brief me as /brief-me does, on spend and return on ad spend by platform, for the last full week against the week before.
13
2. Report the three biggest moves first. Do not ask me anything.

Only a workflow takes a schedule. To run a skill on a schedule, write a workflow that follows it.

The schedule block

• Plain cron. Use five fields with no H or R, as Kater’s scheduled jobs do.
• A block that is not valid is ignored. When cron or timezone is not valid, Kater lists the workflow with no schedule, and AI Tools › Workflows shows no time under its name.
• Check it in a terminal. kater library list --kind workflows shows each scheduled workflow’s schedule, such as Scheduled: Every Monday at 08:00, your time zone (0 8 * * 1).

Write a workflow that runs alone

Nobody is there to answer a scheduled run, so write the workflow for that:

• It never asks. It takes every input from your About you or from its own defaults, such as “the last full week”.
• It changes nothing shared. It writes only to your brainstorm folder.
• It ends with a report. What it found is the run’s answer, which your agent shows where it shows a scheduled task’s results.

Next steps

• Starters, the prompts you start by name
• Skills and workflows, what goes in a workflow
• Monday Brief in the Library
• Connect your agent