Config Reference

`Keybinds`

Required chord map with exact modifiers, optional repeat overrides, and context scopes.

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.

keybinds:
  mod "super"
  "$var.mod+left" "focus-left"
  "$var.mod+ctrl+left" "resize-window-left" with scope "field"
  "$var.mod+ctrl+left" "cluster-tile-swap-left" with scope "tile"
  "$var.mod+comma" "trail-prev"
  "$var.mod+period" "trail-next"
  "$var.mod+shift+r" "reload"
  "$var.mod+click-left" "move-window"
  "$var.mod+click-right" "resize-window"
  "click-left" "pan-field"
end

`keybinds`

Keyboard, pointer-button, and physical-wheel triggers.

Option	Type	Default	Notes
`mod`	modifier	`super`	Base modifier; generic or exact left/right super, alt, ctrl, or shift.
`<chord> <action>`	binding	`fresh config`	Exact modifier matching; unrecognized actions launch commands.
`with repeat true\|false`	binding attribute	`action default`	Overrides held-key repeat.
`with scope global\|field\|cluster\|tile\|stack`	binding attribute	`action default`	Allows duplicate chords in non-overlapping contexts.
`click-* \| scroll-* \| keycode-* \| button-*`	physical triggers	`none`	Pointer, wheel, and numeric evdev trigger forms.

`built-in actions`

Actions parsed before command fallback.

Option	Type	Default	Notes
`quit \| close-focused \| reload \| screenshot`	global actions	`builtin`	Session, close, reload, and native capture actions.
`toggle-fullscreen \| maximize-focused \| toggle-state \| toggle-focused-pin`	window actions	`builtin`	Focused-window state actions.
`focus-<direction> \| cycle-focus \| cycle-focus-backward`	navigation	`builtin`	Contextual direction and MRU navigation.
`trail-prev \| trail-next \| center-last-focused`	Field navigation	`builtin`	Per-output history and Field centering.
`node-move <direction> \| resize-window-<direction>`	Field actions	`builtin`	Moves a node or resizes a Field window.
`monitor-focus <direction\|output>`	global action	`builtin`	Focuses an adjacent or exact named output.
`cluster-mode \| cluster-layout-cycle \| cluster-slot-<1-10>`	cluster actions	`builtin`	Creates, lays out, and activates clusters.
`cluster-toggle-float \| cluster-tile-swap-<direction>`	cluster actions	`builtin`	Floats a member or reorders a tiling layout.
`apogee \| bearings-show \| bearings-toggle`	overlay actions	`builtin`	Spatial overview and navigation overlays.
`move-window \| resize-window \| pan-field`	pointer actions	`builtin`	Remappable compositor grabs.
`zoom-in \| zoom-out \| zoom-reset \| default-terminal`	global actions	`builtin`	Camera zoom and terminal launch.
`<command>`	command line	`fallback`	Any non-built-in action is launched as a command.