Sessionizer for Herdr

42lizard.sessionizer is a fuzzy workspace picker for Herdr. It lists existing workspaces alongside project directories and either focuses the selected workspace or creates one for the selected directory.

Requirements

• Herdr 0.8.2 or newer
• Linux or macOS
• fzf, fd, and jq

On macOS, install the command-line dependencies with Homebrew:

brew install fzf fd jq

Installation

Install from GitHub:

herdr plugin install 42lizard/herdr-sessionizer

For local development, clone and link the plugin directory:

git clone https://github.com/42lizard/herdr-sessionizer.git
cd herdr-sessionizer
herdr plugin link "$PWD" --enabled

Configuration

On first use, the plugin creates ~/.config/herdr/plugins/config/42lizard.sessionizer/folders from folders.example. Add one search root per line; blank lines and lines beginning with # are ignored, and paths may start with ~/.

~/projects
~/Desktop

Sessionizer searches directories one or two levels below each configured root.

Optionally, add a keybinding to ~/.config/herdr/config.toml:

[[keys.command]]
key = "prefix+f"
type = "plugin_action"
command = "42lizard.sessionizer.open"
description = "Find or create workspace"

Usage

Run Find or create workspace from Herdr's plugin actions, or invoke it from the command line:

herdr plugin action invoke 42lizard.sessionizer.open

Type to filter the list, press Enter to focus or create a workspace, or press Escape to cancel.

License

MIT