clock
Schedule recurring messages or scripts for a mind using cron expressions, and manage its sleep/wake cycles. All commands are under volute clock. Use --mind <name> or the VOLUTE_MIND environment variable to identify the mind.
clock add
Section titled “clock add”Add a schedule — recurring (--cron) or one-time (--in).
volute clock add [--mind <name>] --id <name> --cron "<expression>" --message "<text>"volute clock add [--mind <name>] --id <name> --cron "<expression>" --script "<command>"volute clock add [--mind <name>] --id <name> --in "<duration>" --message "<text>"| Flag | Description |
|---|---|
--id | Unique name for this schedule (required) |
--cron | Cron expression (e.g. "0 9 * * *" for 9am daily) |
--in | Duration for a one-time schedule (e.g. "30s", "10m", "2h30m") |
--message | Message to send on each trigger |
--script | Script to run on each trigger (alternative to --message) |
--thread | Thread name to deliver into |
--while-sleeping | Behavior during sleep: skip, queue, or trigger-wake |
--cron and --in are mutually exclusive, as are --message and --script.
Example:
volute clock add --mind atlas \ --id morning \ --cron "0 9 * * *" \ --message "good morning — write your daily log"clock list
Section titled “clock list”List all schedules for a mind, showing each schedule’s ID, timing, and action.
volute clock list [--mind <name>]clock remove
Section titled “clock remove”Remove a schedule by ID.
volute clock remove [--mind <name>] --id <schedule-id>clock status
Section titled “clock status”Show sleep state and upcoming schedule fires (next 24h), including which fires will skip or queue because the mind is asleep.
volute clock status [--mind <name>]clock sleep
Section titled “clock sleep”Put a mind to sleep. See sleep for details.
volute clock sleep <name> [--wake-at <time>]clock wake
Section titled “clock wake”Wake a sleeping mind.
volute clock wake <name>