Focused, independently installable plugins for Herdr.
To use every plugin in this repository, install Herdr 0.7.4 or newer and Node.js 24.12 or newer within the Node.js 24 release line. Each plugin is installed separately, so choose only what you need.
Install the plugin, then number any tabs that already exist:
herdr plugin install oullin/herdr-plugins/plugins/tab-numbers
herdr plugin action invoke oullin.tab-numbers.syncInstall the plugin, then apply the tmux-style profile:
herdr plugin install oullin/herdr-plugins/plugins/tmux-keybindings
herdr plugin action invoke oullin.tmux-keybindings.applyInstall the plugin, then add hints to the panes that are already open:
herdr plugin install oullin/herdr-plugins/plugins/pane-navigation-hints
herdr plugin action invoke oullin.pane-navigation-hints.refreshHerdr previews each plugin and its build and runtime commands before confirming an interactive installation.
| Plugin | Description | Minimum Herdr |
|---|---|---|
| Tab Numbers | Adds each named tab's contiguous position to its label. | 0.7.0 |
| Tmux Keybindings | Applies tmux-style bindings with a modal reference dialog. | 0.7.4 |
| Pane Navigation Hints | Shows live pane navigation shortcuts in every pane border. | 0.7.4 |
The sync action re-indexes all named tabs. Creation, rename, move, and close events keep the numbers contiguous afterwards. See the Tab Numbers documentation for behaviour and cleanup details.
Use apply to install the profile, toggle to open or close the reference dialog, and restore to recover the bindings that existed before the first apply. See the Tmux Keybindings documentation for the complete keymap.
Use refresh after changing Herdr's key configuration and clear to remove the plugin-owned legends. Newly created panes receive the current legend automatically. See the Pane Navigation Hints documentation for configuration and cleanup details.
This repository is already published through the Herdr plugin marketplace. Search for oullin/herdr-plugins to find the collection.
Herdr does not use a submission form or review queue for community plugins. Its marketplace automatically indexes public GitHub repositories carrying the herdr-plugin topic and refreshes about every 30 minutes. The marketplace creates one listing for this repository; the install commands above select the individual plugin from its repository subdirectory.
To keep the listing discoverable:
- Keep
oullin/herdr-pluginspublic and unarchived. - Keep the
herdr-pluginGitHub topic attached. - Keep the repository description accurate.
- Verify the entry in the marketplace after publishing changes.
See Herdr's marketplace documentation for the current indexing rules.
@oullin/herdr-plugin-core is the private, repository-local runtime SDK shared by these plugins. Each plugin declares it through a file: dependency, and Herdr installs that dependency from the same managed repository checkout.
Requirements:
Install Fmtkit with Homebrew:
brew tap oullin/fmtkit
brew install --cask fmtkitInstall and validate the complete workspace:
make format-all
vp install --frozen-lockfile
vp run readymake format-all formats and lints every TypeScript file. vp run ready runs vp check followed by the complete test suite. See the plugin conventions before adding a package.