Config Reference

`Autostart Commands`

Startup/reload commands and optional named startup clusters.

Defaults

Defaults shown here are the effective built-in defaults for the selected wiki version.

Default Config Shape

Use this as the section shape when editing halley.rune.

autostart:
end

Commands Halley runs on compositor startup or config reload.

Option	Type	Default	Notes
`once`	command string	`none`	Runs once when the compositor starts.
`on-reload`	command string	`none`	Runs after a config reload.
`cluster`	repeated nested block	`none`	Optional named startup clusters with name, members, layout, and output. Fresh sessions declare no clusters. Empty members [] creates an empty named core.

Repeat a cluster block for each intentional named startup workspace. Halley starts with no clusters unless declared.

Option	Type	Default	Notes
`name`	string	`required`	Persistent cluster name.
`members`	command string array	`required`	Commands launched into the cluster. Empty arrays create a named core without launching applications.
`layout`	tiling \| stacking	`clusters.default-layout`	Initial workspace layout.
`output`	connector string	`primary output`	Optional output such as DP-2.