scheduled_task_cli

CLI for managing scheduled tasks with full CRUD operations. Tasks are stored locally as JSON and validated with Zod schemas.

Install

npm install
npm run build

Usage

# Run in development mode
npm run dev -- <command> [options]

# Run built version
npm start -- <command> [options]

All commands accept a global -o, --output <format> option to control output format (json or markdown). Defaults to json.

Commands

create

Create a new scheduled task.

scheduled_task_cli create \
  -n "Daily report" \
  -d "Generate the daily summary report" \
  -b "Run aggregation queries and email results" \
  -f "daily/09:00"

| Flag | Description | |------|-------------| | -n, --name | Task name (required) | | -d, --descriptions | Task description (required) | | -b, --body | Task body (required) | | -f, --frequency | Task frequency (required) |

list

List all scheduled tasks.

scheduled_task_cli list
scheduled_task_cli ls          # alias

get

Get a single task by UUID.

scheduled_task_cli get <uuid>

update

Update one or more fields on an existing task.

scheduled_task_cli update <uuid> -n "New name" -f "weekly/monday/08:00"

Same flags as create, but all are optional (at least one required).

delete

Delete a task by UUID.

scheduled_task_cli delete <uuid>

query

Query tasks by creation date range (ISO 8601).

scheduled_task_cli query -s 2026-01-01 -e 2026-12-31

Frequency Format

| Value | Example | |-------|---------| | manual | One-off, no schedule | | hourly | Every hour | | daily/HH:MM | daily/09:00 | | weekdays/HH:MM | weekdays/17:30 | | weekly/{day}/HH:MM | weekly/monday/08:00 |

Storage

Tasks are persisted to .scheduled_task_cli/tasks.json relative to the package root.

Tech Stack

• TypeScript
• Commander.js
• Zod (validation)
• Chalk (terminal colors)