dsh-clock-context

Configuration

Every option is optional. Set them in your profile's cordis.patch.yml (or in an overlay) under the entry this bundle inserts:

- id: dsh-clock-context
  config:
    timeZone: Asia/Shanghai   # any IANA zone; default: the host's zone
    locale: zh-CN             # default: the host's locale
    label: 当前时间            # default: "Current date/time"
    includeUtc: true          # default: true
    includeEpoch: false       # default: false (unix seconds)
    precision: minute         # 'second' (default) or 'minute'
    hint: true                # default: true (append the "authoritative clock" sentence)
    order: 105                # default: 105 (before SANDBOX_POLICY=110)
    enabled: true             # default: true

Option	Type	Default	Meaning
timeZone	string	host zone	IANA zone for the rendered local time
locale	string	host locale	Passed to Intl.DateTimeFormat
label	string	Current date/time	Prefix of the injected line
includeUtc	boolean	true	Append the UTC instant
includeEpoch	boolean	false	Append unix seconds
precision	'second' | 'minute'	'second'	'minute' renders a snapshot that only changes once a minute
hint	boolean	true	Append the "use this, never guess" sentence
order	number	105	Sort order inside the runtime-context snapshot
enabled	boolean	true	Turn the contribution off without uninstalling

The timezone offset is computed per call, so daylight-saving transitions are handled automatically.

On precision. DSH only re-records a runtime-context snapshot when its text changes, so at second precision the snapshot is re-recorded every turn. That is cheap — the snapshot is a tail user-role message, so it does not invalidate the cached prefix — but if you prefer the lowest possible churn, precision: minute makes the text change at most once a minute.

Note on locale. It defaults to the host's locale, so a zh-CN machine renders 2026年09月12日星期六 13:12:21 while the label stays English. Set locale: 'en-US' for Saturday, 09/12/2026, 13:12:21, or set label to match the locale you choose.