herdr-compass

Unified directional navigation for Herdr across panes, tabs, and workspaces.

• left / right: focus a pane, then wrap to the previous / next tab.
• up / down: focus a pane, then wrap to the previous / next workspace, including worktrees.

Requires Herdr 0.7+ and Python 3.10+ as python3. No Python packages needed.

Install

From the public repo:

herdr plugin install ycros/herdr-compass
herdr plugin action invoke herdr-compass.right

Keys

Add to ~/.config/herdr/config.toml:

[[keys.command]]
key = "prefix+h"
type = "plugin_action"
command = "herdr-compass.left"
description = "compass left"

[[keys.command]]
key = "prefix+j"
type = "plugin_action"
command = "herdr-compass.down"
description = "compass down"

[[keys.command]]
key = "prefix+k"
type = "plugin_action"
command = "herdr-compass.up"
description = "compass up"

[[keys.command]]
key = "prefix+l"
type = "plugin_action"
command = "herdr-compass.right"
description = "compass right"

If those chords are already assigned to Herdr's built-in pane focus keys, remove or clear the built-ins. Then reload:

herdr server reload-config

License

MIT.