快速开始

如果还没有安装 Herdr,请参见安装。然后在任意项目目录中启动 Herdr:

herdr

Herdr 会启动或连接到你的默认后台会话。你不需要管理 socket。即使分离,智能体也会继续运行。

创建工作区

当会话中没有工作区时,Herdr 会自动打开一个。工作区是项目级别的容器,容纳标签页、窗格和智能体。给每个活跃项目一个独立的工作区,这样侧边栏里的智能体状态才清晰可读。

使用鼠标

Herdr 是鼠标原生的,所以从点击开始。点击窗格、标签页、工作区和智能体来聚焦它们。拖动分割边框来调整大小。右键打开上下文菜单,包括分割窗格和创建标签页。拖选文本即可复制到剪贴板;双击一个词直接复制它。复制不需要 Ctrl+C。

当终端把带修饰键的点击传给 Herdr 时,Ctrl+点击可以打开窗格内的链接。这对 OSC 8 超链接和可见的 http:// 或 https:// URL 有效。在 macOS 上,鼠标捕获开启时,请用 Ctrl+点击来触发 Herdr 处理的窗格链接;Cmd+点击只能通过终端原生的绕过路径使用,比如 Shift+Cmd+点击或 ui.mouse_capture = false。

如果配置了 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 工作流。
• 智能体 — 受支持的智能体、检测,以及提升状态准确度的集成。
• 配置 — 按键绑定、主题、通知,以及其他一切。