Skip to content
Yardmaster Guide

Run a cron job on a schedule

A cron job runs a command, a recipe or an agent session at the times you choose, such as every weekday at 9am, as long as Yardmaster is open.

Intermediate3 minutes
Open in YardmasterOpens Yardmaster. Don't have it? Download
Yardmaster

A cron job does a task for you on a schedule: run a script every night, start an agent every weekday morning, or run a recipe once a week. It runs while Yardmaster is open, even if you are not looking.

Make a cron job#

  1. In the sidebar, open Automation, then Cron Jobs.

  2. Click + Add Job.

  3. Give it a Name.

  4. Under Job Type, pick Script (a command on your computer), Recipe, or Session (an agent with your Prompt, in a Project you pick).

  5. Under Schedule, pick a preset such as Weekdays at 9am, or Custom... to type your own.

  6. Choose Recurring, Run once or Run N times.

  7. Click Create Job.

A job you create yourself starts on its schedule right away. Turn on Require Approval if you want to approve each run in your Inbox first. A job an agent creates for you always waits for your approval, and so does an agent's change to an approved job.

Run, pause or delete a job#

Click a job to see its settings and Run History. Run Now runs it once straight away. Disable stops it running on its schedule until you click Enable. Delete removes the job and its history after you confirm.

If you have used Yardmaster for a while, some jobs may have come from a recipe's schedule. For those, also pause that schedule under Recipe schedules in My Automations: disabling or deleting the job alone lets the recipe's schedule run again, and it spends like before.

What if Yardmaster was closed?#

A job only runs while Yardmaster is open. If your computer was off or asleep at the scheduled time, that run is skipped. Turn on Run if missed on a recurring job to have it run once the next time you open Yardmaster, for misses in the last 7 days. However many runs were missed, it catches up with one run, then carries on as normal.

Let an agent fix a failing job#

With Self-Healing on, when a job fails for good (after its retries), Yardmaster pauses it and starts an agent session in the job's project to fix it. The agent resumes the job once the fix works.

Cron failure alertsSettings, Notifications · Default: OnShow a system notification and inbox card when a cron job fails permanentlyOpen in YardmasterOpens Yardmaster. Don't have it? Download

Learn Yardmaster, Let it run itself: lesson 2 of 3

Put work on a schedule

Next lesson

Did this help?