快速开始
Preview build
2026-10-14-fbd2ae23927f, published from fbd2ae23927f. Stable docs remain at /docs/.
如果还没有安装 Herdr,请参见安装。然后在任意项目目录中启动 Herdr:
herdrHerdr 会启动或连接到你的默认后台会话。你不需要管理 socket。即使分离,智能体也会继续运行。
当会话中没有工作区时,Herdr 会自动打开一个。工作区是项目级别的容器,容纳标签页、窗格和智能体。给每个活跃项目一个独立的工作区,这样侧边栏里的智能体状态才清晰可读。
Herdr 是鼠标原生的,所以从点击开始。点击窗格、标签页、工作区和智能体来聚焦它们。拖动分割边框来调整大小。右键打开上下文菜单,包括分割窗格和创建标签页。拖选文本即可复制到剪贴板。双击一个词可以选中它；按住第二次点击并拖动，会按整词扩展选择。两种操作都会在松开鼠标时复制。复制不需要 Ctrl+C。
当终端把带修饰键的点击传给 Herdr 时,Ctrl+点击可以打开窗格内的链接。这适用于 OSC 8 超链接及 http:// 或 https:// URL，包括首尾部分位于可见区域之外的换行链接。按住 Ctrl 并将指针移到链接上，会为可见部分添加下划线。移开指针、窗格内容变化或收到 Ctrl 释放事件时，高亮会清除；部分终端只在鼠标移动时报告修饰键变化。
ui.mouse_capture = true（默认）时，Herdr 处理 Ctrl+点击。匹配的已启用插件先执行。处理器启动失败会显示错误并停止。没有匹配插件的 http:// 和 https:// 链接在运行 Herdr 客户端的机器上用默认浏览器打开。其他链接需要匹配的插件。此模式不会把显式超链接传给外层终端，因此标签链接无法通过终端原生操作打开，包括 macOS 的 Command+点击。
ui.mouse_capture = false 时，显式超链接会传给外层终端，使用终端通常的快捷键和警告。这些点击不会调用 Herdr 插件。关闭捕获也会禁用 Herdr 的鼠标操作，包括点击标签页和拖动分割边框。
Windows Terminal 仍可能抢先打开从可见文本中检测到的 URL。要让插件可靠地优先处理这些 URL，请在 Windows Terminal 的 settings.json 中设置 "experimental.detectURLs": false。此设置适用于所有配置文件。Herdr 不会更改它。
如果配置了 ui.right_click_passthrough_modifier,该修饰键加右键会把右键点击、按住和拖动手势发送给启用鼠标上报的窗格应用。
在窗格里启动你的编程智能体:
claude也可以是 codex、pi、opencode 或任何其他受支持的智能体。Herdr 会自动检测。侧边栏会显示每个智能体处于 working、blocked、done 还是 idle — 并且跨所有工作区显示,所以你总能知道哪个项目需要你。
键盘操作是可选的;鼠标可以完成一切。按 ctrl+b 进入前缀模式,然后按一个动作键。
常用动作:
| 动作 | 按键 |
|---|---|
| 向右分割 | prefix+v |
| 向下分割 | prefix+minus |
| 新建标签页 | prefix+c |
| 下一个 / 上一个标签页 | prefix+n / prefix+p |
| 工作区导航 | prefix+w |
| 新建工作区 | prefix+shift+n |
| 分离客户端 | prefix+q |
第一次接触前缀键的概念?键盘会解释它是什么、为什么终端复用器要用它,以及如何做到不用前缀键。在 Herdr 里按 prefix+? 查看所有生效的绑定,按 prefix+[ 进入复制模式用键盘复制。
按 prefix+q,或者直接关掉终端窗口。Herdr 服务器和所有智能体会继续运行。再次运行 herdr 即可重新连接到同一个会话。
要真正结束会话并停止其中的窗格:
herdr server stop- 核心概念 — 两分钟了解工作区、标签页、窗格和智能体模型。
- 使用 Herdr 的工作方式 — 本地、SSH、手机和
herdr --remote工作流。 - 智能体 — 受支持的智能体、检测,以及提升状态准确度的集成。
- 配置 — 按键绑定、主题、通知,以及其他一切。