Give Herdr macOS keyboard shortcuts with Ghostty

July 17, 2026 · 1 min read

I got tired of keeping a cheat sheet open for Herdr’s keyboard shortcuts, so I made them match the macOS native shortcuts: cmd+t for a new tab, cmd+w to close, cmd+d to split, cmd+1..9 to jump workspaces.

It’s just two changes. First, in your Ghostty config, map the native chords to the sequences Herdr listens for (\x02 is Herdr’s ctrl+b prefix):

# ~/.config/ghostty/config

# macos/chrome-style herdr actions
keybind = cmd+KeyT=text:\x02t
keybind = cmd+t=unbind
keybind = cmd+KeyN=text:\x02n
keybind = cmd+n=unbind
# cmd+w closes the focused pane; cmd+shift+w force-closes the whole tab
keybind = cmd+KeyW=text:\x02x
keybind = cmd+w=unbind
keybind = cmd+shift+KeyW=text:\x02W
keybind = cmd+shift+w=unbind

# rename: cmd+r -> tab, cmd+shift+r -> workspace
keybind = cmd+KeyR=text:\x02T
keybind = cmd+r=unbind
keybind = cmd+shift+KeyR=text:\x02N
keybind = cmd+shift+r=unbind

# splits: cmd+d vertical, cmd+shift+d horizontal
keybind = cmd+KeyD=text:\x02v
keybind = cmd+d=unbind
keybind = cmd+shift+KeyD=text:\x02-
keybind = cmd+shift+d=unbind

# zoom active pane
keybind = cmd+shift+enter=text:\x02z

# pane navigation: cmd+opt+hjkl
keybind = cmd+alt+KeyH=text:\x02h
keybind = cmd+alt+KeyJ=text:\x02j
keybind = cmd+alt+KeyK=text:\x02k
keybind = cmd+alt+KeyL=text:\x02l

# pane cycling: cmd+[ prev, cmd+] next
keybind = cmd+left_bracket=text:\x02i
keybind = cmd+right_bracket=text:\x02u

# cmd+1..9 -> herdr workspaces
keybind = cmd+1=text:\x1b[49;6u
keybind = cmd+2=text:\x1b[50;6u
keybind = cmd+3=text:\x1b[51;6u
# ...through cmd+9

Then, in your Herdr config, remap a few keys to match the chords above:

# ~/.config/herdr/config.toml

[keys]
prefix = "ctrl+b"

new_tab = "prefix+t"
new_workspace = "prefix+n"
close_tab = "prefix+shift+w"
rename_workspace = "prefix+shift+n"
cycle_pane_previous = "prefix+i"
cycle_pane_next = "prefix+u"

Gist here: https://gist.github.com/venables/1b634058f9f4eafe1327d73930a3d3cd