hoziron cron

Manage scheduled jobs — create time-based agent invocations.

Synopsis

hoziron 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 cron list

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

Example

$ hoziron 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 cron list --agent claims-agent
ID      SCHEDULE        PROMPT                           STATUS
j-001   0 */6 * * *     Process pending claims queue     enabled

hoziron cron create

hoziron 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 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 cron create monitor-agent "0 8 * * *" "Generate a daily health and performance report"
✓ Job created (id: j-005)

# Weekly summary every Monday
$ hoziron 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 cron create escalation-agent "*/5 * * * *" "Check for claims needing escalation"
✓ Job created (id: j-007)

hoziron cron delete

$ hoziron cron delete j-004
✓ Job deleted

hoziron cron enable / disable

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

$ hoziron 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.