Skip to content

ash schedule

Manage scheduled tasks that Ash runs automatically.

Usage

Terminal window
uv run ash schedule <action> [OPTIONS]

Actions

ActionDescription
listList all scheduled tasks
cancelCancel a specific task by ID
clearClear all scheduled tasks

Options

OptionDescription
--id, -iTask ID (8-char hex) for cancel
--force, -fSkip confirmation prompts
--helpShow help message

Examples

List all scheduled tasks:

Terminal window
uv run ash schedule list

Cancel a specific task:

Terminal window
uv run ash schedule cancel --id a1b2c3d4

Clear all tasks (with confirmation):

Terminal window
uv run ash schedule clear

Clear all tasks without confirmation:

Terminal window
uv run ash schedule clear --force

Output

List Output

┌──────────┬──────────┬─────────────────────┬─────────────────────┬──────────┬─────┐
│ ID │ Type │ Message │ Schedule │ Provider │ Due │
├──────────┼──────────┼─────────────────────┼─────────────────────┼──────────┼─────┤
│ a1b2c3d4 │ periodic │ Check weather for...│ 0 8 * * * │ telegram │ no │
│ e5f6g7h8 │ one-shot │ Remind me to... │ 2024-01-15 14:00:00 │ cli │ yes │
└──────────┴──────────┴─────────────────────┴─────────────────────┴──────────┴─────┘
Total: 2 task(s)

Task Types

One-shot Tasks

Run once at a specific time:

Remind me to call mom at 3pm tomorrow

Periodic Tasks

Run on a schedule (cron format):

Every morning at 8am, tell me the weather

Storage

Scheduled tasks are stored in ~/.ash/workspace/schedule.jsonl.

See Also

  • serve - Run the server (required for schedule execution)