herdr-sesh¶

A Sesh-inspired workspace picker and session manager for Herdr.

herdr-sesh combines running Herdr workspaces, configured sessions, and zoxide history in one searchable overlay. Selecting an item focuses its existing workspace or creates a new one with the configured startup command and tabs.

Install¶

herdr plugin install fullerzz/herdr-plugin-sesh

Open the picker through the installed plugin action:

herdr plugin action invoke fullerzz.sesh.open-picker

Documentation¶

Use the version selector in the header to choose a release's documentation. latest follows the main branch and may describe changes not yet released. Release snapshots are available starting with v0.10.0, when the wiki was added.

For changes in each release, see the release notes.

First steps¶

1. Open the picker, type part of a workspace name or path, then press Enter.
2. Bind the picker to a key in Herdr.
3. Optionally create a configuration and add a named workspace with tabs.

Use Ctrl+O to switch command and active-pane previews, and Ctrl+R to cycle workspace sorting. Picker controls lists the other shortcuts. If something looks wrong, start with Troubleshooting.

Reference¶

• Configuration explains config discovery, picker behavior, workspaces, tabs, and legacy Sesh migration.
• Keybindings shows how to invoke the picker and related actions from Herdr.
• Commands covers direct CLI use and installed-binary setup.
• Contributing covers local development, tests, docs, and releases.
• GitHub releases contains versioned source and release notes.

Requirements¶

• Herdr 0.8.2 or newer
• Linux or macOS
• Git and Go 1.26.4 or newer for Herdr's source-based plugin installation
• Optional: zoxide for directory history and eza for the default preview
• Optional: fzf and bat for the experimental fzf picker