Skip to main content
The schedule command manages scheduled agent execution.

Usage

praisonai schedule [OPTIONS] COMMAND [ARGS]...

Commands

CommandDescription
addAdd a scheduled job
startStart scheduled agent execution
stopStop scheduled job(s)
listList scheduled jobs
logsView scheduler logs
restartRestart a scheduled job
deleteDelete a scheduled job
describeShow job details
statsShow scheduler statistics

Adding Jobs

praisonai schedule add "job-name" \
  --schedule "cron:0 9 * * *" \
  --message "Good morning! Check tasks." \
  --agent support \
  --channel telegram \
  --channel-id 12345

Options

OptionShortDescription
--schedule-sWhen to run: hourly, daily, */30m, cron:..., at:..., in 20 minutes
--message-mPrompt text to deliver
--agent-aAgent ID to execute this job (default: first registered)
--channelDelivery platform: telegram, discord, slack, whatsapp, email, agentmail
--channel-idTarget chat/channel ID
--session-idSession ID to preserve conversation context
--jsonOutput JSON

Examples

Add a daily reminder bound to a specific agent

praisonai schedule add "morning-hello" -s daily -m "say hello" --agent support

Add with delivery target

praisonai schedule add "tg-reminder" \
  -s "cron:0 9 * * *" \
  -m "check email" \
  --agent support \
  --channel telegram \
  --channel-id 12345

Start scheduler

praisonai schedule start

List scheduled jobs

praisonai schedule list
praisonai schedule list --json

View logs

praisonai schedule logs
praisonai schedule logs --tail 100 --follow

Stop a job

praisonai schedule stop job-123
praisonai schedule stop all

Delete a job

praisonai schedule delete job-123 --yes

See Also