komrad

Schedules

Launch agents or mail an orchestrator on a timer, and what happens when a run is late or busy.

Edit on GitHub

Komrad can spawn or message agents on a schedule, which suits periodic work such as summaries.

Schedules fire on a cron expression and hand their prompts to an agent. They keep firing after you close the panel, as long as the engine is running.

There are two kinds of schedules: task schedules start a new task each time, and orchestrator schedules mail a running orchestrator.

Task schedules#

A task schedule starts a new task in a workflow each time it fires, with a writer that gets the schedule’s prompt as its brief. The workflow supplies everything else about the launch when the schedule fires, such as the directory, the flags and the shared context.

Open the schedules from the switcher at the top of the panel, open the menu with space and press c to write one. Leave the kind on task, then give it a name, a cron expression, a prompt, and the neovim workflow. The name also names every agent it launches.

The video uses * * * * * so the schedule fires within a minute.

A task schedule never piles up work. If the writer from its last run is still working or waiting on you, the next run is skipped and recorded as skipped.

Orchestrator schedules#

An orchestrator schedule mails its prompt to an orchestrator that is already running. Use it when the work belongs to an agent that already knows the workflow, such as asking the orchestrator each morning to hand out the day’s work.

If the orchestrator is archived or deleted, the schedule’s runs are cancelled. Edit it to point at another orchestrator, or archive it.

Missed and paused runs#

Komrad never catches up on missed runs. If the server is down when a run was due, that run is skipped. This is deliberate, so agents do not start at odd hours.

Komrad cancels runs that cannot succeed and records the reason as the schedule’s last run. For instance, it cancels a task schedule whose workflow no longer exists.

You can pause a schedule and arm it again later. A paused schedule keeps its settings.