Herdr Cheat Sheet & Quick Reference

Essentials

$herdr

Launch Herdr or attach to the default session.

$curl -fsSL https://herdr.dev/install.sh | sh
$curl -fsSL https://herdr.dev/install.sh | sh

Install Herdr on Linux or macOS with the official install script.

$powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

Install Herdr on Windows from PowerShell; ARM64 systems run the x86_64 build under emulation.

$brew install herdr
$brew install herdr

Install Herdr with Homebrew.

$mise use -g herdr

Install Herdr with mise.

$herdr --remote workbox

Attach to a remote machine over SSH, using your local keybindings.

$herdr --session work

Open a named session instead of the default session.

Ctrl + b q

Detach from the TUI and leave every pane running.

Ctrl + b ?

Show every active keybinding in the help panel.

Ctrl + b ? then /

Filter actions and shortcuts in the keybinding help panel.

$herdr --default-config

Print the complete default config to stdout.

$herdr update

Update an installer-managed Herdr build from the configured channel.

$brew upgrade herdr
$brew upgrade herdr

Update Herdr installed with Homebrew.

$mise upgrade herdr

Update Herdr installed with mise.

Panes

Ctrl + b v

Split the focused pane to the right.

Ctrl + b -

Split the focused pane downward, opening a new pane below.

Ctrl + b h / j / k / l

Move focus to the pane left, down, up, or right.

Ctrl + b z

Zoom the focused pane to fill the tab.

Ctrl + b x

Close the focused pane.

Ctrl + b shift + h / j / k / l

Swap the focused pane with the pane in a direction.

Ctrl + b r

Enter resize mode for the focused pane.

Drag

Drag-select text with the mouse to copy it without entering copy mode.

Tabs & Workspaces

Ctrl + b c

Create a new tab in the active workspace.

Ctrl + b n / p

Move to the next or previous tab.

Ctrl + b 1..9

Jump directly to tab 1 through 9.

Ctrl + b shift + t

Rename the active tab.

Ctrl + b shift + x

Close the active tab.

Ctrl + b shift + n

Create a new workspace.

Ctrl + b shift + w

Rename the active workspace.

Ctrl + b shift + d

Close the active workspace.

Ctrl + b w

Enter workspace navigation; leave it with Esc or Ctrl+[.

Ctrl + b g

Open the Goto picker to jump to an agent or terminal.

Ctrl + b b

Toggle the sidebar dashboard.

Copy Mode & Text Fields

Ctrl + b [

Enter copy mode for the focused pane.

h / j / k / l

Move by character or line in copy mode.

w / b / e

Move by word in copy mode.

W / B / E

Move by big word in copy mode.

{ / }

Jump to the previous or next paragraph in copy mode.

PageUp / PageDown

Page up or down in copy mode.

Ctrl + U / Ctrl + D

Scroll half a page up or down in copy mode.

/ or ? then n / N

Search the pane's scrollback and repeat matches.

v or Space

Start a selection in copy mode.

y or Enter

Copy the active selection in copy mode.

q or Esc

Leave copy mode without copying.

Ctrl + A / Ctrl + E

Move to the beginning or end of a Herdr text field.

Ctrl + U / Ctrl + K

Cut from the cursor to the beginning or end of a Herdr text field.

Ctrl + W / Alt + Backspace / Ctrl + Backspace

Cut the previous word in a Herdr text field.

Alt + D

Cut the next word in a Herdr text field.

Ctrl + Y

Insert the last cut text into a Herdr text field.

Launch, Status & Machines

$herdr status

Print the overall Herdr status.

$herdr status server

Print the server status.

$herdr --version

Print the installed Herdr version.

$herdr channel show

Show the current update channel.

$herdr channel set preview

Opt into preview builds.

$herdr completion zsh

Generate a shell completion script.

$herdr machine add workbox --label "Build machine"

Save an SSH machine profile with a label.

$herdr machine status "Build machine"

Check a saved machine's reachability.

$herdr --machine "Build machine" agent list

Route a CLI command to a saved SSH machine.

Sessions, Workspaces & Panes

$herdr session list

List Herdr sessions.

$herdr session attach work

Attach to a named session.

$herdr workspace list

List workspaces.

$herdr workspace create --cwd ~/project --label api --no-focus

Create a workspace without stealing focus.

$herdr tab create --workspace <workspace_id> --label logs

Create a tab in a workspace with a label.

$herdr tab close <tab_id>

Close a tab by ID.

$herdr pane list

List panes.

$herdr pane split <pane_id> --direction right --ratio 0.3

Split a pane to the right with a ratio.

$herdr pane focus --direction left

Focus the pane in a direction.

$herdr pane read <pane_id> --source recent-unwrapped --lines 120

Read recent unwrapped pane output.

$herdr pane run <pane_id> "npm test"

Run a command in a pane and submit it with Enter.

$herdr pane close <pane_id>

Close a pane by ID.

Agents, Plugins & Integrations

$herdr agent list

List detected and started agents.

$herdr agent start reviewer --kind claude --pane <pane_id>

Start a named agent in an available shell pane.

$herdr agent prompt reviewer "review this diff" --wait

Send a prompt to an agent and wait for a settled state.

$herdr agent wait reviewer --until idle

Wait for an agent to reach a specific state.

$herdr agent read reviewer --lines 80

Read an agent's terminal output.

$herdr agent send-keys reviewer esc

Send logical keys to an agent.

$herdr agent focus reviewer

Focus an agent in the UI.

$herdr integration install claude

Install the Claude agent integration.

$herdr integration status --outdated-only

Show only integrations with outdated versions.

$herdr plugin install ogulcancelik/herdr-plugin-examples/worktree-bootstrap --yes

Install a plugin from GitHub shorthand.

$herdr plugin list

List installed plugins.

$herdr plugin action invoke <action_id>

Invoke an installed plugin action.

$herdr worktree create --cwd ~/project --branch review

Create a Git worktree checkout as a workspace.

Configuration

[keys] prefix = "ctrl+a"

Change the prefix key inside the keys table.

[keys] prefix = ["ctrl+space", "ctrl+s"]

Enter prefix mode from more than one key.

[keys] focus_pane_left = ["prefix+h", "ctrl+alt+h"]

Add a direct chord alongside the prefix binding.

[keys] switch_tab = "prefix+1..9"

Bind an indexed jump across tabs 1 through 9.

[theme] name = "catppuccin"

Choose a built-in theme in the theme table.

[theme] auto_switch = true

Let the theme follow the terminal's light or dark appearance.

[theme.custom] accent = "#a6e3a1"

Override a single theme color.

[terminal] default_shell = "nu"

Set the executable used for new interactive panes.

[terminal] new_cwd = "follow"

Set the working directory policy for new panes, tabs, and workspaces.

$mkdir -p ~/.config/herdr && ${EDITOR:-vi} ~/.config/herdr/config.toml
$notepad %APPDATA%\herdr\config.toml
$mkdir -p ~/.config/herdr && ${EDITOR:-vi} ~/.config/herdr/config.toml

Open the Herdr config file for editing.

$herdr server reload-config

Apply reloadable settings without restarting panes.

$herdr config reset-keys

Back up config.toml, drop custom keybindings. Takes effect after a restart or reload.