hoziron-cli cron

Manage scheduled jobs — create time-based agent invocations.

Synopsis

hoziron-cli cron <subcommand> [options]

Subcommands

Subcommand	Description
`list`	List scheduled jobs
`create <agent> <spec> <prompt>`	Create a new job
`delete <id>`	Delete a job
`enable <id>`	Enable a disabled job
`disable <id>`	Disable without deleting

hoziron-cli cron list

hoziron-cli cron list [--agent <name>] [--json]

Example

$ hoziron-cli cron list
ID      AGENT            SCHEDULE        PROMPT                           STATUS
j-001   claims-agent     0 */6 * * *     Process pending claims queue     enabled
j-002   monitor-agent    */5 * * * *     Check system health metrics      enabled
j-003   report-agent     0 8 * * 1       Generate weekly claims report    disabled

$ hoziron-cli cron list --agent claims-agent
ID      SCHEDULE        PROMPT                           STATUS
j-001   0 */6 * * *     Process pending claims queue     enabled

hoziron-cli cron create

hoziron-cli cron create <agent> <spec> <prompt> [--name <name>]

Flags

Flag	Description
`--name <name>`	Human-readable job name (auto-generated if omitted)

Cron Expression Format

Standard 5-field cron: minute hour day-of-month month day-of-week

Expression	Meaning
`/5 * * *`	Every 5 minutes
`0 * * * *`	Every hour
`0 /6 * *`	Every 6 hours
`0 8 * * *`	Daily at 8:00 AM
`0 8 * * 1`	Every Monday at 8:00 AM
`0 0 1 * *`	First day of each month at midnight

Examples

# Process claims queue every 6 hours
$ hoziron-cli cron create claims-agent "0 */6 * * *" "Process all pending claims in the queue" \
    --name "claims-queue-processor"
✓ Job created (id: j-004)

# Daily health report
$ hoziron-cli cron create monitor-agent "0 8 * * *" "Generate a daily health and performance report"
✓ Job created (id: j-005)

# Weekly summary every Monday
$ hoziron-cli cron create report-agent "0 8 * * 1" "Generate weekly claims summary report for management"
✓ Job created (id: j-006)

# Every 5 minutes: check for escalations
$ hoziron-cli cron create escalation-agent "*/5 * * * *" "Check for claims needing escalation"
✓ Job created (id: j-007)

hoziron-cli cron delete

$ hoziron-cli cron delete j-004
✓ Job deleted

hoziron-cli cron enable / disable

$ hoziron-cli cron disable j-001
✓ Job j-001 disabled (schedule paused)

$ hoziron-cli cron enable j-001
✓ Job j-001 enabled (schedule resumed)

How Cron Jobs Work

The daemon's internal scheduler evaluates cron expressions
When a job fires, the configured prompt is sent to the agent as a message
The agent processes it like any interactive message
Results are available in the agent's session history

Cron jobs only fire while the daemon is running. Missed schedules (daemon was down) are not retroactively executed.