Cron & Scheduling

Cron & Scheduling System

Dewee includes an in-process cron scheduler (internal/cron/) supporting standard cron expressions and human-friendly interval strings like @every 24h or @every 30m.

Overview & Architecture

The scheduler manages two distinct classes of scheduled executions:

1. Agent Scheduled Tasks: Dispatches user-configured prompts and workflow triggers to specific agents at scheduled intervals.
2. Operator System Tasks: Runs recurring background jobs such as periodic memory consolidation, session compaction, and license status checks.

CLI Management Workflows

# Create a daily summary cron task
dewee cron create --name "daily-standup" --schedule "@every 24h" --message "Summarize yesterday activities"

# List all active and paused cron jobs
dewee cron list

# Inspect detailed status of a specific job
dewee cron get <job-id-or-name>

# Trigger immediate execution of a scheduled job
dewee cron run <job-id-or-name>

# Inspect execution history runs
dewee cron runs <job-id-or-name>

# Enable or disable a job
dewee cron toggle <job-id> true

# Delete a scheduled job
dewee cron delete <job-id>

Failure Recovery & Error Handling

• If an agent is busy during scheduled execution, the task queues in the background event queue with exponential backoff.
• Failed executions log structured errors with trace correlation IDs visible via dewee traces list.