Herdr Pretty Which

Herdr Pretty Which cover

A which-key style training overlay for Herdr, built as a Rust/Ratatui plugin.

It reads your real Herdr config, merges it with known defaults, and renders a searchable keybinding guide with list/tree modes, assigned/unassigned filtering, and contrast-safe selection styling. It does not invent bindings; values are marked as default, config, or unset based on the loaded config.

Install

Plugin linking requires Herdr's plugin-capable line (herdr >= 0.7.0). If herdr --version reports an older version, use the snapshot command for now or upgrade Herdr before running herdr plugin ... commands.

cargo install herdr-pretty-which --locked
herdr plugin link cargo
herdr plugin pane open --plugin ramarivera.pretty-which --entrypoint overlay --placement overlay --focus

Local development

Use the checkout path only when developing the plugin itself:

cargo install --path . --locked
herdr plugin link .
herdr plugin pane open --plugin ramarivera.pretty-which --entrypoint overlay --placement overlay --focus

Keybinding

Bind the plugin action through Herdr's command keybinding support:

[[keys.command]]
name = "Pretty Which"
description = "open pretty which"
key = "prefix+space"
type = "plugin_action"
command = "ramarivera.pretty-which.open"

Controls

↑/↓: move selection
type: fuzzy filter
Backspace: edit filter
Tab / Shift+Tab: cycle ALL / ASSIGNED / UNASSIGNED
Ctrl+T: toggle LIST / TREE
←/→: collapse/expand or move through tree groups
Ctrl+[ / Ctrl+]: collapse/expand all tree groups
Esc / q: close

Testing

cargo test
cargo test --test render_snapshots
cargo test --test cli_e2e

Optional live Herdr smoke test, only when you explicitly want the socket/plugin loop:

$env.HERDR_LIVE_E2E = "1"
cargo test --test live_herdr_e2e -- --ignored