Skip to main content

herdr-helpr

Prompt-driven workspace and pane management for herdr. Name workspaces before they're created, rename them in-place, and close everything but what you're focused on — all through keyboard-driven overlays that stay out of your flow.

Install

bash
herdr plugin install sohanemon/herdr-helpr

Clones, builds, and registers the plugin. Actions appear in herdr's UI immediately.

Manual

bash
git clone https://github.com/sohanemon/herdr-helpr
cd herdr-helpr
bun install
herdr plugin link "$PWD"

Tools

IDTypeTitleDescription
workspace:createpaneNew WorkspaceCreate a workspace with an optional name
workspace:renamepaneRename WorkspaceRename the currently focused workspace
workspace:switchpaneSwitch WorkspaceList all workspaces and pick one to focus
tab:createpaneNew TabCreate a tab with an optional name
tab:renamepaneRename TabRename the currently focused tab
tab:close-otherpaneClose Other TabsClose all non-focused tabs while keeping at least one per workspace
pane:close-otherpaneClose Other PanesClose all non-focused panes
pane:zoom-toggleactionToggle ZoomZoom/unzoom the current pane
pane:floatactionFloating PaneToggle a floating terminal pane (like tmux-float)
tab:floatactionFloating TabToggle a floating scratch tab (like tmux-float)

Usage

Each interactive pane opens an Ink overlay — arrow keys to navigate, ↵ to confirm, esc to cancel.

Bind any action in ~/.config/herdr/config.toml:

toml
[[keys.command]]
key = "alt+n"
type = "plugin_action"
command = "herdr-helpr.workspace:create"
description = "New Workspace"

[[keys.command]]
key = "alt+r"
type = "plugin_action"
command = "herdr-helpr.workspace:rename"
description = "Rename Workspace"

[[keys.command]]
key = "alt+shift+x"
type = "plugin_action"
command = "herdr-helpr.tab:close-other"
description = "Close Other Tabs"

[[keys.command]]
key = "alt+shift+c"
type = "plugin_action"
command = "herdr-helpr.pane:close-other"
description = "Close Other Panes"

Then reload: herdr server reload-config.

Development

bash
bun install
bunx tsc --noEmit
bunx biome check src/
herdr plugin link "$PWD"

Requirements

  • Bun
  • herdr ≥ 0.7.0
  • Linux or macOS