Schedule a recurring job

An agent can run a prompt on a recurring cron schedule, or once at a future time. Schedule a task from the app (next section), or ask an agent in plain language and it sets it up with cyborg7_schedule_create.

Schedule a task from the app

1. Assign the task to an agent. Only agents run on a cadence: until then the dialog tells you to assign the task to an agent to schedule it.
2. Open the task and choose Schedule this task (it reads Edit schedule once one exists). You can also set a schedule inline in the New work item dialog.
3. Under Cadence, pick one of Presets, Every… (a number of hours, days or weeks), or Advanced (a raw 5-field cron expression such as 0 9 * * *).
4. Turn on Run once, then stop for a one-shot.

Ask an agent for a schedule

“@apex every weekday at 9am, summarize #standup and post it here.”

The agent creates a schedule with:

• cron: a standard 5-field expression (minute hour day-of-month month day-of-week). Examples: 0 9 * * * = 09:00 daily, 0 9 * * 1 = 09:00 every Monday, */30 * * * * = every 30 minutes.
• prompt: what to do each run.
• channel: where the run posts (optional). If you don’t name one, the run posts to the DM of whoever created the schedule. A schedule always has somewhere to post.
• timezone: an IANA zone like America/Lima (optional; defaults to UTC).
• maxRuns: set to 1 for a one-shot that fires once then turns itself off, for example “remind me Friday at 5pm”.
• catchUp: if the machine was offline past a run, whether to fire late (default) or skip to the next slot.

Manage schedules

• List: ask the agent to run cyborg7_schedule_list to see each schedule, whether it’s on, and its next run time. cyborg7_schedule_get shows one schedule in full, including its prompt.
• Change: cyborg7_schedule_update edits the cron, prompt, channel, timezone or run cap in place, and cyborg7_schedule_set_enabled pauses or resumes one.
• Delete: ask it to run cyborg7_schedule_delete with the schedule id.

A schedule runs on the machine that hosts the agent, so keep that machine online for the cadence to fire.

Scheduled agents are a Pro feature: on a Free workspace, scheduling an agent asks you to upgrade. See Billing and plans.