crons schema

Canonical generated docsThis section is generated from caco config schema --json. The table below preserves the runtime field path, type, required/default markers, and canonical description for every value in this slice.

Daemon crons — schedule-driven automation entries.

Field path	Type	Required	Default	Canonical description
`crons`	`section`	optional		Daemon crons — schedule-driven automation entries.
└ `crons.name`	`string`	required		Stable operator-facing label for TUI, logs, and execution history.
└ `crons.schedule`	`string`	optional		Cron schedule expression (e.g. '/5 * * *'). Omit for manual-only crons.
└ `crons.action`	`map`	required		Structured action.
└ `crons.action.type`	`string`	required		Action type: command or tmux_send.
└ `crons.action.command`	`string`	optional		Shell command to execute (required when type = command).
└ `crons.action.target`	`string`	optional		Persistent agent declaration name targeted by tmux_send.
└ `crons.action.message`	`string`	optional		Message text sent to the target agent when type = tmux_send.
└ `crons.action.timeout`	`u32`	optional		Timeout in seconds.
└ `crons.nodes`	`list[string]`	optional		Node names allowed to execute; omit for all nodes.
└ `crons.enabled`	`bool`	optional	true	Global on/off switch. 'false' disables the cron scheduled tick entirely (never auto-fires on any node, orthogonal to 'nodes'). Omit or 'true' to enable. Honored by the daemon cron loop.
└ `crons.check`	`string`	optional		Side-effect-free shell command that exercises the cron's prerequisites. Run by 'caco cron check' and the daemon check sweep with CACO_CRON_CHECK=1, never by the schedule.
└ `crons.project`	`string`	optional		Project the cron acts as: it runs with that project's environment, agent-spawn GitHub routing and the configured account's gh credential. Omit for the node's ambient environment.