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

# Tasks & Scheduling

> Schedule agent prompts to run daily, weekly, or monthly, and manage every automated task in your workspace

Tasks run an agent prompt on a schedule — daily cost checks, weekly security audits, monthly executive reports — with no one needing to remember them. Schedule a prompt once and the assigned agent runs it automatically at the configured times.

## Prerequisites

* A workspace with at least one active [connection](/guide/connections/overview)
* Familiarity with the `@agent #tool instruction` syntax — see [CloudThinker Language](/guide/language)

## Schedule a task from the console

The fastest way to create a scheduled task is directly from the conversation input.

<Steps>
  <Step title="Write your task prompt">
    In the console input area, type the prompt you want to run on a schedule. Mention the agent, add a tool tag, then the instruction.

    ```text theme={null}
    @kai #alert Check error logs from the last 24 hours and alert on high or critical issues
    ```
  </Step>

  <Step title="Click the calendar icon">
    In the input toolbar, click the **calendar icon** (next to the send button) to open the scheduling options.

    <Frame>
      <img src="https://mintcdn.com/cloudthinker/zfWJ0ARVidFv3mPf/images/setup/recurring-tasks/01-schedule-task-button.png?fit=max&auto=format&n=zfWJ0ARVidFv3mPf&q=85&s=c4bb5111632c66732d160448f06d01b8" alt="CloudThinker console input area showing the calendar icon for scheduling recurring tasks" width="2182" height="1170" data-path="images/setup/recurring-tasks/01-schedule-task-button.png" />
    </Frame>

    <p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>The calendar icon in the input toolbar opens the task scheduling panel</p>
  </Step>

  <Step title="Configure the schedule">
    Set when the task runs:

    * **Frequency** — daily, weekly, monthly, or a custom interval
    * **Time** — when the task should run (for example, 9:00 AM)
    * **Day** — for weekly tasks, which day(s); for monthly, which date
  </Step>

  <Step title="Save the task">
    Review the configuration and click **Save**.

    **Success state:** the task appears under **Tasks** in your workspace with its next run time.
  </Step>
</Steps>

## Create a task from the Tasks page

Use the Tasks page when you want to name and configure a task before it first runs.

<Steps>
  <Step title="Open the Tasks page">
    Navigate to **Tasks** in your workspace and click **Create Task**.
  </Step>

  <Step title="Configure the task">
    Fill in the task details:

    * Name and description
    * Agent to execute the task
    * Prompt to run
    * Schedule (optional — leave empty for an on-demand task you trigger manually)
  </Step>

  <Step title="Save and enable">
    Save the task, then enable it to activate the schedule.

    **Success state:** the task is listed with its frequency and next run time.
  </Step>
</Steps>

## Cadence examples

| Cadence       | Prompt                                                                                                       |
| ------------- | ------------------------------------------------------------------------------------------------------------ |
| Daily         | `@alex #report Analyze EC2 spending trends and flag anomalies over $100`                                     |
| Daily         | `@tony #report Check database slow queries and report any taking over 5 seconds`                             |
| Every 6 hours | `@kai #alert Monitor Kubernetes pod health and alert on CrashLoopBackOff`                                    |
| Weekly        | `@oliver #report Run a security audit across all connected AWS accounts`                                     |
| Weekly        | `@alex #recommend Review unused resources across all connected cloud accounts`                               |
| Monthly       | `@anna #report Generate an executive infrastructure summary with cost, security, and performance highlights` |
| Monthly       | `@oliver #report Run a SOC 2 compliance check and generate a remediation report`                             |

<Tip>
  Start with weekly or monthly tasks that replace work your team already does manually, then add daily tasks once you trust the output. Scope prompts tightly — name the accounts, regions, and thresholds you care about.
</Tip>

## Manage tasks

Open **Tasks** in your workspace to manage everything you have scheduled:

| Action       | What it does                                                  |
| ------------ | ------------------------------------------------------------- |
| View         | See all tasks with next run time, frequency, and status       |
| Pause        | Temporarily disable a task without deleting its configuration |
| Edit         | Update the prompt, schedule, or agent assignment              |
| Delete       | Remove a task that is no longer needed                        |
| View history | Review past runs, including output, duration, and any errors  |

Pair tasks with [notifications](/guide/notifications) so results reach the right people by email or Slack, and review run history periodically to tune prompts and schedules.

## Next steps

<CardGroup cols={2}>
  <Card title="Operations Hub" icon="gauge" href="/guide/operations-hub">
    Browse pre-built operations you can schedule as tasks
  </Card>

  <Card title="Autonomous Agents" icon="robot" href="/guide/automation/autonomous-agents">
    Go beyond schedules with continuous monitoring and operations
  </Card>

  <Card title="Notifications" icon="bell" href="/guide/notifications">
    Configure where task results and failure alerts are delivered
  </Card>

  <Card title="Webhooks" icon="webhook" href="/guide/webhooks/overview">
    Trigger tasks from external events and push results to your systems
  </Card>
</CardGroup>
