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

# tai schedules

> Manage scheduled jobs.

Manage scheduled jobs.

```console theme={null}
$ tai schedules [OPTIONS] COMMAND [ARGS]...
```

## `tai schedules add`

Create a schedule that periodically runs a tool.

Example: `tai schedules add report --schedule-kw cron='0 9 * * *'`

```console theme={null}
$ tai schedules add [OPTIONS] TOOL_NAME
```

| Argument    | Description                                 |
| ----------- | ------------------------------------------- |
| `TOOL_NAME` | The tool to run on a schedule. *(required)* |

| Option                     | Description                              |
| -------------------------- | ---------------------------------------- |
| `--tool-kwargs` `TEXT`     | Tool arguments as a JSON object.         |
| `--tool-kw` `TEXT`         | A key=value tool argument (repeatable).  |
| `--schedule-kwargs` `TEXT` | Schedule cadence params as JSON.         |
| `--schedule-kw` `TEXT`     | A key=value schedule param (repeatable). |
| `--json` / `--no-json`     | Emit raw JSON instead of human tables.   |

## `tai schedules delete`

Delete a schedule by name.

Example: `tai schedules delete report`

```console theme={null}
$ tai schedules delete [OPTIONS] NAME
```

| Argument | Description                 |
| -------- | --------------------------- |
| `NAME`   | Schedule name. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai schedules list`

List the configured schedules.

Example: `tai schedules list`

```console theme={null}
$ tai schedules list [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai schedules server-datetime`

Get the server's current date and time.

Example: `tai schedules server-datetime`

```console theme={null}
$ tai schedules server-datetime [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |