> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enconvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Scheduled Jobs

> Run Agents and shell commands once or on a repeating schedule.

Scheduled Jobs runs a task at a chosen time and keeps a history of its results. A job can ask an Agent to carry out an instruction or run a shell command on your Mac.

<Frame caption="Unsaved scheduled Agent job with a weekly schedule.">
  <img src="https://mintcdn.com/thegreatlionheartpteltd/hQPNJJatkK6kD6HF/images/guides/scheduled-job-editor.jpg?fit=max&auto=format&n=hQPNJJatkK6kD6HF&q=85&s=983107e9b219df6dab7dbe610fbbcee4" alt="Unsaved scheduled Agent job with a weekly schedule" width="624" height="844" data-path="images/guides/scheduled-job-editor.jpg" />
</Frame>

## Create a job

<Steps>
  <Step title="Open Scheduled Jobs">
    Go to **Settings → Agents → Scheduled Jobs** and select **Create a job**. You can also ask an Agent to schedule a task when its scheduling tools are available.
  </Step>

  <Step title="Choose what to run">
    Name the job. Choose **Ask an agent**, select an Agent, and write a complete instruction. Each run starts a fresh conversation. For a script, choose **Run a shell command** and supply the command and any working-directory options shown.
  </Step>

  <Step title="Set the schedule">
    Choose **Once**, **Every day**, **Weekly**, **Monthly**, **Interval**, or **Cron**. Check the **Next runs (local time)** preview before saving.
  </Step>

  <Step title="Choose where results go">
    Leave **Send each result to a chat** off to keep results in run history. Turn it on to select a connected IM channel and chat. You may need to talk to the Agent in that chat first so it appears in the picker.
  </Step>

  <Step title="Test and save">
    Use **Test run** to save and execute the job immediately, or **Create job** to save it for its scheduled time. Test run really executes the instruction or script; use a harmless example while learning.
  </Step>
</Steps>

<Frame caption="A weekly Agent job with an example instruction; this draft has not been saved.">
  <img src="https://mintcdn.com/thegreatlionheartpteltd/hQPNJJatkK6kD6HF/images/guides/scheduled-job-editor.jpg?fit=max&auto=format&n=hQPNJJatkK6kD6HF&q=85&s=983107e9b219df6dab7dbe610fbbcee4" alt="Scheduled job editor with a complete Agent instruction and weekday schedule" width="624" height="844" data-path="images/guides/scheduled-job-editor.jpg" />
</Frame>

## Read the run history

Open a job's history to see whether execution succeeded, the output, and any delivery error. **Open conversation** opens the Agent run; **Copy** copies its output. **Send again** attempts delivery again and sends a real message to the configured destination.

| Status                    | What to check                                                     |
| ------------------------- | ----------------------------------------------------------------- |
| Failed                    | The instruction, Agent tools, shell exit status, or error details |
| Succeeded / Not delivered | The job ran, but its IM destination or channel needs attention    |
| Done / no more runs       | A one-time job has finished and has no next scheduled run         |
| Paused                    | Resume it if you want future runs                                 |

Use **Needs attention** to find failed runs or failed deliveries. Search, status filters, and batch pause/resume help manage a larger list.

## Scheduling details

* Enconvo must be running and your Mac available for local jobs to execute. Do not treat a sleeping or offline Mac as an always-on scheduler.
* One-time jobs require a future date. After running, they have no next run.
* Monthly dates 29–31 are skipped in months without that date.
* Check the displayed local-time preview, especially after travel or a time-zone change.
* **More options** includes a description and a maximum run count.
* Run history is bounded; copy important outputs elsewhere before clearing history or deleting a job.

Related: [IM Channels](/integrations/messaging), [Agents](/ai/agents), [Workflows](/workflows/introduction).

## Watch the steps

<video controls playsInline preload="none" poster="/images/guides/scheduled-job-editor.jpg" aria-label="Draft a scheduled Agent job" style={{width: "100%", maxHeight: "640px"}}>
  <source src="https://mintcdn.com/thegreatlionheartpteltd/hQPNJJatkK6kD6HF/videos/guides/scheduled-jobs.mp4?fit=max&auto=format&n=hQPNJJatkK6kD6HF&q=85&s=7713aa435c6fc517c2e0f6935e306bf5" type="video/mp4" data-path="videos/guides/scheduled-jobs.mp4" />

  [Download the walkthrough](/videos/guides/scheduled-jobs.mp4).
</video>

Fill the name and instruction, switch to Weekly, choose weekdays, and compare Monthly. The draft is discarded; no job is created. This silent walkthrough uses real interface captures with pauses added for reading. The written steps above provide the same instructions.