Skip to content

Schedules

A schedule runs a workflow, an operation or an agent on a timetable, so overnight batches and regular check-ins happen without you pressing Run. Open Workflows and click the calendar icon in the toolbar.

Tasks run while their project is open in Kitlig. They need the project to work, so there's no running them with it closed.

Add a task

  1. Click Run a Workflow, Run an Operation or Ask an Agent.
  2. Give it a name, and choose when it runs: every so many minutes or hours, daily at a time, weekly on the days you pick, or when the project opens.
  3. Fill in the form. It's the same set of inputs you get in Sandbox or in the workflow's Run dialog. An agent task takes a prompt and which agent to ask, and it shows up as a normal session in the Assistant.
  4. Set Most runs per day, then click Save.
  5. Tick the box next to the task in the list to switch it on.

New tasks start paused, because they can spend money with nobody watching. Run now runs a task once whether it's on or not, which is a good way to test it first.

Missed runs

If a task comes due while the project is closed, it runs once when you next open the project, however many times it was missed. The history marks that run Caught up.

Time spent paused doesn't count, so switching a task on never sets off a backlog. When a task reaches Most runs per day it waits for the next day.

See what ran

History lists every run with when it started, what set it off and how it ended. Click one to see the inputs it ran with, and the files or the reply it produced. Kitlig keeps the latest 300 runs per project.

Projects you get from someone else

Whether a task is switched on is stored on your computer, not in the project. A project someone sends you can contain tasks, but they stay paused until you tick them.

If a task you switched on gets changed outside this panel, for instance by a project sync, it pauses and says so. Tick it again once you've looked at it.

Automation operations

Nobody's at the keyboard when a schedule fires, so Call Function, Run JavaScript and the other Automation operations follow the rule for agents. They're refused unless Let MCP clients and the assistant run these is on in Settings. Run now counts as you pressing Run.