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

# Schedule

> Scheduler management for automated agent execution

The `schedule` command manages scheduled agent execution.

## Usage

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai schedule [OPTIONS] COMMAND [ARGS]...
```

## Commands

| Command    | Description                     |
| ---------- | ------------------------------- |
| `add`      | Add a scheduled job             |
| `start`    | Start scheduled agent execution |
| `stop`     | Stop scheduled job(s)           |
| `list`     | List scheduled jobs             |
| `logs`     | View scheduler logs             |
| `restart`  | Restart a scheduled job         |
| `delete`   | Delete a scheduled job          |
| `describe` | Show job details                |
| `stats`    | Show scheduler statistics       |

## Adding Jobs

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai schedule add "job-name" \
  --schedule "cron:0 9 * * *" \
  --message "Good morning! Check tasks." \
  --agent support \
  --channel telegram \
  --channel-id 12345
```

### Options

| Option         | Short | Description                                                                         |
| -------------- | ----- | ----------------------------------------------------------------------------------- |
| `--schedule`   | `-s`  | When to run: `hourly`, `daily`, `*/30m`, `cron:...`, `at:...`, `in 20 minutes`      |
| `--message`    | `-m`  | Prompt text to deliver                                                              |
| `--agent`      | `-a`  | Agent ID to execute this job (default: first registered)                            |
| `--channel`    |       | Delivery platform: `telegram`, `discord`, `slack`, `whatsapp`, `email`, `agentmail` |
| `--channel-id` |       | Target chat/channel ID                                                              |
| `--session-id` |       | Session ID to preserve conversation context                                         |
| `--json`       |       | Output JSON                                                                         |

## Examples

### Add a daily reminder bound to a specific agent

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai schedule add "morning-hello" -s daily -m "say hello" --agent support
```

### Add with delivery target

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai schedule add "tg-reminder" \
  -s "cron:0 9 * * *" \
  -m "check email" \
  --agent support \
  --channel telegram \
  --channel-id 12345
```

### Start scheduler

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai schedule start
```

### List scheduled jobs

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai schedule list
praisonai schedule list --json
```

### View logs

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai schedule logs
praisonai schedule logs --tail 100 --follow
```

### Stop a job

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai schedule stop job-123
praisonai schedule stop all
```

### Delete a job

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai schedule delete job-123 --yes
```

## See Also

* [Scheduler](/docs/cli/scheduler) - Scheduler details
* [Background](/docs/cli/background) - Background tasks