Keybindings¶

The native picker and settings controls work in both integrations. Herdr actions below apply to the Herdr TUI plugin. For Herdr app mod bindings in keys.json, see the app picker and last-space setup.

Native picker controls¶

Key	Action
`Enter`	Focus the selected workspace, or create it for a configured session or directory.
`Esc` / `Ctrl`+`C`	Close the picker without selecting a workspace.
`Down` / `Ctrl`+`N` / `Ctrl`+`J`	Move from the filter into the list, then move down.
`Up` / `Ctrl`+`P` / `Ctrl`+`K`	Move up while the list is focused; moving above its first row returns to the filter. In the filter, `Ctrl`+`K` keeps its text-editing behavior.
`Right`	Return from the list to the filter; within the filter, move the text cursor.
`Ctrl`+`U`	Clear the filter and focus it.
`Ctrl`+`V`	Paste into the filter.
`Ctrl`+`R`	Cycle workspace → recent → agent sorting for Herdr workspaces.
`Ctrl`+`O`	Switch command/pane previews, unless overridden by `keys.cycle_preview_mode`.
`F2`	Open settings; uses Ctrl+, when preview cycling is bound to F2.
`Ctrl`+`X`	Close the selected running Herdr workspace and refresh the list.

Typing updates the filter even when the list is focused. These controls describe the native picker; the experimental fzf picker uses its own controls.

Left-click a workspace row to select it and switch immediately, just like Enter. Clicking a configured session or directory creates or focuses its workspace. Mouse selection also works with stacked or hidden previews.

Mouse capture is enabled in every native picker layout, and the wheel follows the up/down controls. To select text for copying, use your terminal's mouse override (often Shift-drag).

Closing a workspace

Ctrl+X requests a workspace close immediately, without a picker confirmation. It affects the running workspace, not just its row. It does nothing for configured sessions or directory results. During the request, selection is disabled; Esc requests cancellation and exits once the request returns. Cancellation cannot undo a close that already completed.

Native picker previews¶

By default, press Ctrl+O to switch between command and active-pane previews. The heading shows the current shortcut; configure another key or disable cycling through keys.cycle_preview_mode. Switching modes does not save the choice; set picker.preview_mode to change the initial mode. Cycling is disabled when show_preview = false.

For side-by-side previews, drag the vertical divider with the left mouse button. Both panels keep a minimum width; the chosen width resets when the picker closes. Narrow terminals stack the preview below the list. These controls apply to the native picker, not fzf.

Herdr actions¶

The fullerzz.sesh.last action switches to the previously focused workspace, including switches made outside the picker. History is separate for each Herdr session and closed workspaces are pruned automatically. See Workspace history for details.

Prerequisite

Build and link this checkout, or install a published release with herdr plugin install fullerzz/herdr-plugin-sesh --ref <release-tag> using a tag from the GitHub releases page.

Example Herdr keybinding once the plugin is linked:

Add this to Herdr's ~/.config/herdr/config.toml (or the file selected by HERDR_CONFIG_PATH / XDG_CONFIG_HOME), not the plugin's config.toml.

[keys]
# If using "prefix+shift+t" to open the herdr-sesh plugin picker, the rename_tab keybind needs to be changed.
rename_tab = "prefix+shift+,"

[[keys.command]]
key = "prefix+shift+t"
type = "plugin_action"
command = "fullerzz.sesh.open-picker"
description = "open Sesh picker"

[[keys.command]]
key = "prefix+shift+b"
type = "plugin_action"
command = "fullerzz.sesh.last"
description = "switch to previous Sesh workspace"

Manual picker open:

herdr plugin pane open --plugin fullerzz.sesh --entrypoint picker --placement overlay

Settings controls¶

Key	Action
Up / Down, Tab / Shift+Tab	Select a setting.
Enter / Space	Toggle a boolean, cycle a choice, or open an editor.
Left / Right	Cycle choices backward / forward.
Ctrl+R	Revert the selected setting to its loaded value.
Ctrl+S	Apply text/list edits to the draft; from the form, review all changes.
Enter in a text editor	Insert a newline; use Ctrl+S to apply.
`\t` / `\\` in a text editor	Represent a tab / literal backslash. Pasted text is escaped automatically.
A / Enter / D in a list	Add / edit / delete an item.
Ctrl+Up / Ctrl+Down in a list	Reorder items.
Y in save review	Confirm writing the reviewed changes.
Esc	Cancel the current edit, close review, or return; confirm before discarding unsaved changes.

In Herdr TUI, open settings directly with:

herdr plugin action invoke fullerzz.sesh.open-settings

In the Herdr app, use the picker's settings shortcut or run herdr-sesh config edit.

See Settings editor for file handling and migration.