herdr shortcuts
herdr is an agent multiplexer — a terminal multiplexer
built around AI coding agents, with workspaces, tabs, panes, git worktrees, and
persistent sessions. Launch it with herdr; it re-attaches to the running
session.
For how this maps onto my old tmux setup, see
tmux vs herdr.
Keybindings
Generated from
terminal/dot-config/herdr/config.toml
(prefix + custom & plugin commands) plus herdr's built-in defaults, by
tools/gen-docs.py — run just docs-update to refresh.
The prefix is Ctrl+b — press it, release, then the key; every Ctrl+b X below means prefix then X.
Tabs
| Key |
Action |
Ctrl+b c |
New tab |
Ctrl+b , |
Rename tab |
Ctrl+b n |
Next tab |
Ctrl+b p |
Previous tab |
Ctrl+b 1-9 |
Jump to tab 1–9 |
Ctrl+b Shift+x |
Close tab |
Panes
| Key |
Action |
Ctrl+b h j k l |
Focus pane ← ↓ ↑ → |
Ctrl+b = |
Split side-by-side |
Ctrl+b - |
Split stacked |
Ctrl+b v |
Split side-by-side (alias) |
Ctrl+b z |
Zoom / fullscreen pane |
Ctrl+b r |
Resize mode (then arrows / hjkl) |
Ctrl+b x |
Close pane |
Ctrl+b Tab |
Cycle to next pane |
Ctrl+b Shift+Tab |
Cycle to previous pane |
Ctrl+b Shift+p |
Rename pane |
Workspaces & sessions
| Key |
Action |
Ctrl+b w |
Workspace picker |
Ctrl+b Shift+n |
New workspace |
Ctrl+b . |
Rename workspace |
Ctrl+b Shift+d |
Close workspace (confirm) |
Ctrl+b Shift+g |
New git-worktree workspace |
Ctrl+b g |
Goto / jump prompt |
Ctrl+b Shift+1-9 |
Jump to workspace 1–9 |
Ctrl+b [ |
Previous workspace |
Ctrl+b ] |
Next workspace |
Ctrl+b q |
Detach session |
Agents
| Key |
Action |
Ctrl+b Alt+1-9 |
Focus agent 1–9 |
Ctrl+b { |
Previous agent |
Ctrl+b } |
Next agent |
| Key |
Action |
Ctrl+b e |
Edit / copy pane scrollback |
Ctrl+b b |
Toggle sidebar |
Ctrl+b Shift+o |
Open latest notification's target |
Ctrl+b s |
Settings |
Ctrl+b ? |
Help / keybinding overlay |
Ctrl+b Shift+r |
Reload config |
Custom commands
| Key |
Action |
Ctrl+b t |
Scratch shell (disposable pane) |
Ctrl+b f |
Pick files (fd+fzf) → inject paths |
Ctrl+b y |
Pick files (yazi UI) → inject paths |
Ctrl+b u |
Grab URLs / paths / IDs from scrollback |
Ctrl+b o |
Switch / open a project workspace |
Ctrl+b Up |
herdr-plus: projects |
Ctrl+b Down |
herdr-plus: quick actions |
Ctrl+b Shift+v |
reviewr: toggle review sidebar |
Direct keys (no prefix)
| Key |
Action |
Alt+h |
vim-nav: focus split / pane left |
Alt+j |
vim-nav: focus split / pane down |
Alt+k |
vim-nav: focus split / pane up |
Alt+l |
vim-nav: focus split / pane right |