Scheduling

Freshness is a nightly stockroom ingest && stockroom embed (incremental, not --full) on the platform scheduler — cron on Linux/WSL, launchd on macOS. Native Windows is not supported; use WSL. Output goes to $STOCKROOM_HOME/logs/nightly.log.

sr-initialize asks before installing the job. You can change the time, skip scheduling entirely, or manage it later:

stockroom schedule status
stockroom schedule install
stockroom schedule install --time 01:15
stockroom schedule remove

install is idempotent — it replaces Stockroom's own entry, never duplicates it, and on cron it only touches a comment-delimited block. If status warns that the cron daemon is not running, the entry is written but will not fire until you start the daemon.

The optional schedule entry is also called out under Installed layout. Session-start hooks never ingest or embed — they only heal the shim and launch the dashboard.