Herdr Cheat Sheet & Quick Reference

基础

$herdr

启动 Herdr 或连接到默认会话。

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

使用官方安装脚本在 Linux 或 macOS 上安装 Herdr。

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

在 Windows 上通过 PowerShell 安装 Herdr;ARM64 系统通过模拟运行 x86_64 构建。

$brew install herdr
$brew install herdr

使用 Homebrew 安装 Herdr。

$mise use -g herdr

使用 mise 安装 Herdr。

$herdr --remote workbox

通过 SSH 连接到远程机器,并使用本地键绑定。

$herdr --session work

打开命名会话,而非默认会话。

Ctrl + b q

从 TUI 分离,让所有窗格继续运行。

Ctrl + b ?

在帮助面板中显示所有生效的键绑定。

Ctrl + b ? then /

在键绑定帮助面板中筛选操作和快捷键。

$herdr --default-config

将完整的默认配置输出到标准输出。

$herdr update

从已配置的渠道更新由安装程序管理的 Herdr 版本。

$brew upgrade herdr
$brew upgrade herdr

更新通过 Homebrew 安装的 Herdr。

$mise upgrade herdr

更新通过 mise 安装的 Herdr。

窗格

Ctrl + b v

将当前聚焦的窗格向右分割。

Ctrl + b -

将当前聚焦的窗格向下分割,在下方打开新窗格。

Ctrl + b h / j / k / l

将焦点移动到左、下、上或右方向的窗格。

Ctrl + b z

放大当前聚焦的窗格以填满标签页。

Ctrl + b x

关闭当前聚焦的窗格。

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

将当前聚焦的窗格与指定方向的窗格交换。

Ctrl + b r

进入当前聚焦窗格的调整大小模式。

Drag

用鼠标拖选文本进行复制,无需进入复制模式。

标签页和工作区

Ctrl + b c

在当前工作区中新建标签页。

Ctrl + b n / p

切换到下一个或上一个标签页。

Ctrl + b 1..9

直接跳转到标签页 1 到 9。

Ctrl + b shift + t

重命名当前标签页。

Ctrl + b shift + x

关闭当前标签页。

Ctrl + b shift + n

新建工作区。

Ctrl + b shift + w

重命名当前工作区。

Ctrl + b shift + d

关闭当前工作区。

Ctrl + b w

进入工作区导航;按 Esc 或 Ctrl+[ 退出。

Ctrl + b g

打开 Goto 选择器,跳转到代理或终端。

Ctrl + b b

切换侧边栏仪表板。

复制模式和文本输入框

Ctrl + b [

为当前聚焦的窗格进入复制模式。

h / j / k / l

在复制模式下按字符或行移动。

w / b / e

在复制模式下按单词移动。

W / B / E

在复制模式下按大单词移动。

{ / }

在复制模式下跳到上一个或下一个段落。

PageUp / PageDown

在复制模式下向上或向下翻页。

Ctrl + U / Ctrl + D

在复制模式下向上或向下滚动半页。

/ or ? then n / N

搜索窗格的滚动缓冲区并重复匹配。

v or Space

在复制模式下开始选择。

y or Enter

在复制模式下复制当前选择。

q or Esc

退出复制模式且不复制。

Ctrl + A / Ctrl + E

移动到 Herdr 文本输入框的开头或末尾。

Ctrl + U / Ctrl + K

从光标处剪切到 Herdr 文本输入框的开头或末尾。

Ctrl + W / Alt + Backspace / Ctrl + Backspace

剪切 Herdr 文本输入框中的上一个单词。

Alt + D

剪切 Herdr 文本输入框中的下一个单词。

Ctrl + Y

将最近剪切的内容插入 Herdr 文本输入框。

启动、状态和机器

$herdr status

输出 Herdr 的整体状态。

$herdr status server

输出服务器状态。

$herdr --version

输出已安装的 Herdr 版本。

$herdr channel show

显示当前更新渠道。

$herdr channel set preview

选择加入预览版本。

$herdr completion zsh

生成 shell 补全脚本。

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

保存带标签的 SSH 机器配置。

$herdr machine status "Build machine"

检查已保存机器的可达性。

$herdr --machine "Build machine" agent list

将 CLI 命令路由到已保存的 SSH 机器。

会话、工作区和窗格

$herdr session list

列出 Herdr 会话。

$herdr session attach work

连接到命名会话。

$herdr workspace list

列出工作区。

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

创建不抢占焦点的工作区。

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

在工作区中创建带标签的标签页。

$herdr tab close <tab_id>

按 ID 关闭标签页。

$herdr pane list

列出窗格。

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

按比例将窗格向右分割。

$herdr pane focus --direction left

将焦点移动到指定方向的窗格。

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

读取最近的未换行窗格输出。

$herdr pane run <pane_id> "npm test"

在窗格中运行命令并按 Enter 提交。

$herdr pane close <pane_id>

按 ID 关闭窗格。

代理、插件和集成

$herdr agent list

列出已检测到和已启动的代理。

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

在可用的 shell 窗格中启动命名代理。

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

向代理发送提示并等待进入稳定状态。

$herdr agent wait reviewer --until idle

等待代理达到特定状态。

$herdr agent read reviewer --lines 80

读取代理的终端输出。

$herdr agent send-keys reviewer esc

向代理发送逻辑按键。

$herdr agent focus reviewer

在界面中聚焦某个代理。

$herdr integration install claude

安装 Claude 代理集成。

$herdr integration status --outdated-only

仅显示版本过旧的集成。

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

通过 GitHub 简写安装插件。

$herdr plugin list

列出已安装的插件。

$herdr plugin action invoke <action_id>

调用已安装插件的操作。

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

创建 Git worktree 检出作为工作区。

配置

[keys] prefix = "ctrl+a"

在 keys 表中更改前缀键。

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

使用多个按键进入前缀模式。

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

在前缀绑定之外添加直接组合键。

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

绑定跨标签页 1 到 9 的索引跳转。

[theme] name = "catppuccin"

在 theme 表中选择内置主题。

[theme] auto_switch = true

让主题跟随终端的浅色或深色外观。

[theme.custom] accent = "#a6e3a1"

覆盖单个主题颜色。

[terminal] default_shell = "nu"

设置新交互式窗格使用的可执行程序。

[terminal] new_cwd = "follow"

设置新窗格、标签页和工作区的工作目录策略。

$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

打开 Herdr 配置文件进行编辑。

$herdr server reload-config

在不重启窗格的情况下应用可重新加载的设置。

$herdr config reset-keys

备份 config.toml 并清除自定义键绑定。重启或重新加载后生效。