docs(config): document palette anchoring

commit: 34848d9734d931e293c6bd2d701f87cb26e48a9d
author: brice · 3mo ago · 2026-07-11 06:45 UTC
parent: 309d975
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email

1 file · +8 -0

M README.md +8 -0


@@ -49,6 +49,10 @@ vev reads `$XDG_CONFIG_HOME/vev/config`, or `~/.config/vev/config` when `XDG_CON
49	49		# Theme: auto follows the client; dark/light force built-in palettes.
50	50		theme = auto
51	51
	52	+	# Palette placement: auto, center, top-left, top, top-right, left, right,
	53	+	# bottom-left, bottom, or bottom-right.
	54	+	palette.anchor = auto
	55	+
52	56		# One prewarmed floating terminal per tab. An empty command uses the normal shell.
53	57		floating.command =
54	58		floating.width = 80%

@@ -114,6 +118,10 @@ Key specs support `alt+<char>`, `alt+space`, and `alt+left/right/up/down`; digit
114	118
115	119		`floating.command` runs through the normal shell; leave it empty to launch that shell directly. `floating.width` and `floating.height` require exact percentages from `1%` through `100%`; invalid values log a warning and leave the last accepted value (or the `80%` default) intact. Reloading does not relaunch or immediately alter an installed floating terminal: a changed command is used on its next launch, while changed dimensions take effect when that terminal is next shown or resized. Only configuration—not floating runtime state—is restored after a daemon restart; restored tabs stay cold until first visited.
116	120
	121	+	### Command palette anchoring
	122	+
	123	+	`palette.anchor` accepts `auto` or the nine anchors `center`, `top-left`, `top`, `top-right`, `left`, `right`, `bottom-left`, `bottom`, and `bottom-right`. Values are trimmed and case-insensitive. The default is `auto`: palettes use the bottom shelf when the terminal is narrower than 96 columns, and a 64-column bottom-right rail at 96 columns or wider. An explicit anchor changes placement only; palette query and selection are preserved. Invalid values are warned about and leave the last valid value unchanged, as do duplicate entries until a valid replacement is supplied (the last valid value wins). Configuration reload applies a changed anchor live and repositions an open palette without resetting its query or selection.
	124	+
117	125		### Bar right anchors
118	126
119	127		The top and bottom bar right anchors run configurable commands on the daemon host. By default, `bar.top-right = vev-bar-top-right` prints CPU, memory, then hour text (for example `C 12% M 48% 09:41`), and `bar.bottom-right = vev-bar-bottom-right` prints compact git state for the focused pane's `VEV_PANE_CWD`. Set either value empty to disable that anchor, or set it to another command to replace it.


@@ -49,6 +49,10 @@ vev reads `$XDG_CONFIG_HOME/vev/config`, or `~/.config/vev/config` when `XDG_CON
49	# Theme: auto follows the client; dark/light force built-in palettes.	49		# Theme: auto follows the client; dark/light force built-in palettes.
50	theme = auto	50		theme = auto
51		51
		52	+	# Palette placement: auto, center, top-left, top, top-right, left, right,
		53	+	# bottom-left, bottom, or bottom-right.
		54	+	palette.anchor = auto
		55	+
52	# One prewarmed floating terminal per tab. An empty command uses the normal shell.	56		# One prewarmed floating terminal per tab. An empty command uses the normal shell.
53	floating.command =	57		floating.command =
54	floating.width = 80%	58		floating.width = 80%

@@ -114,6 +118,10 @@ Key specs support `alt+<char>`, `alt+space`, and `alt+left/right/up/down`; digit
114		118
115	`floating.command` runs through the normal shell; leave it empty to launch that shell directly. `floating.width` and `floating.height` require exact percentages from `1%` through `100%`; invalid values log a warning and leave the last accepted value (or the `80%` default) intact. Reloading does not relaunch or immediately alter an installed floating terminal: a changed command is used on its next launch, while changed dimensions take effect when that terminal is next shown or resized. Only configuration—not floating runtime state—is restored after a daemon restart; restored tabs stay cold until first visited.	119		`floating.command` runs through the normal shell; leave it empty to launch that shell directly. `floating.width` and `floating.height` require exact percentages from `1%` through `100%`; invalid values log a warning and leave the last accepted value (or the `80%` default) intact. Reloading does not relaunch or immediately alter an installed floating terminal: a changed command is used on its next launch, while changed dimensions take effect when that terminal is next shown or resized. Only configuration—not floating runtime state—is restored after a daemon restart; restored tabs stay cold until first visited.
116		120
		121	+	### Command palette anchoring
		122	+
		123	+	`palette.anchor` accepts `auto` or the nine anchors `center`, `top-left`, `top`, `top-right`, `left`, `right`, `bottom-left`, `bottom`, and `bottom-right`. Values are trimmed and case-insensitive. The default is `auto`: palettes use the bottom shelf when the terminal is narrower than 96 columns, and a 64-column bottom-right rail at 96 columns or wider. An explicit anchor changes placement only; palette query and selection are preserved. Invalid values are warned about and leave the last valid value unchanged, as do duplicate entries until a valid replacement is supplied (the last valid value wins). Configuration reload applies a changed anchor live and repositions an open palette without resetting its query or selection.
		124	+
117	### Bar right anchors	125		### Bar right anchors
118		126
119	The top and bottom bar right anchors run configurable commands on the daemon host. By default, `bar.top-right = vev-bar-top-right` prints CPU, memory, then hour text (for example `C 12% M 48% 09:41`), and `bar.bottom-right = vev-bar-bottom-right` prints compact git state for the focused pane's `VEV_PANE_CWD`. Set either value empty to disable that anchor, or set it to another command to replace it.	127		The top and bottom bar right anchors run configurable commands on the daemon host. By default, `bar.top-right = vev-bar-top-right` prints CPU, memory, then hour text (for example `C 12% M 48% 09:41`), and `bar.bottom-right = vev-bar-bottom-right` prints compact git state for the focused pane's `VEV_PANE_CWD`. Set either value empty to disable that anchor, or set it to another command to replace it.