Getting started
Terminal setup
Pick a terminal, free the keys that Herdr needs, and copy Dave's Ghostty config if you want the same look.
Herdr runs inside a normal terminal. Dave uses Ghostty. The mouse works in Herdr without extra settings, and Ghostty gives up its own shortcuts with one line of config.
How it works
A terminal owns some shortcuts itself. Cmd+T opens a terminal tab, Cmd+W closes one. Press them and the terminal acts before Herdr sees the key. If you want Herdr to use those keys, the terminal has to release them first.
In Ghostty, one line per key does that in ~/.config/ghostty/config.
keybind = super+t=unbindReload with Cmd+Shift+, or restart Ghostty after a change.
Other terminals
On iTerm2, Warp, or the macOS Terminal app, mouse clicks in Herdr may select text instead of focusing a pane, and Cmd shortcuts may be captured before Herdr sees them. Each terminal has its own settings for mouse reporting and key bindings. Free the same keys there, or switch to Ghostty.
Dave's setup
brew install --cask ghosttyThe unbind lines match the shortcuts on the keyboard page. The rest is font size, padding, and colors. The Neovim theme on a later page uses the same background, so the editor sits flush in the terminal.
# Let these Cmd keys reach Herdr and Neovim.
keybind = super+t=unbind
keybind = super+w=unbind
keybind = super+k=unbind
keybind = super+e=unbind
keybind = super+shift+g=unbind
# Look and feel
background = #1D1E27
foreground = #FDFDFD
font-size = 14
window-padding-x = 10
window-padding-y = 8
cursor-style = bar
cursor-style-blink = false
scrollback-limit = 100000
macos-option-as-alt = true
palette = 0=#282A2B
palette = 1=#F3977F
palette = 2=#5ADECD
palette = 3=#F272A2
palette = 4=#886F97
palette = 5=#C574DD
palette = 6=#79E6F3
palette = 7=#FDFDFD
palette = 8=#415844
palette = 9=#FF4971
palette = 10=#18E3C8
palette = 11=#FF8037
palette = 12=#556FFF
palette = 13=#B0D143
palette = 14=#3FDCEE
palette = 15=#BEBEC1Ghostty ships with a Nerd Font built in, so the icons in Neovim and lazygit render without a font install.
On Windows
Ghostty has no official Windows build. Use Windows Terminal. Herdr supports it, and the mouse works.
Windows Terminal owns Ctrl+Shift+T, Ctrl+Shift+W, and Ctrl+Tab. To free a key, open Settings, then Actions, find the shortcut, and delete it. Paste with Ctrl+Shift+V. Install a Nerd Font and select it in the profile settings, or the icons in Neovim and lazygit show as boxes.
Check
Press Cmd+T in the terminal. Nothing should happen. The terminal no longer owns that key, and Herdr is not running yet to receive it.