一个让 AI 智能体永不掉线的终端工作区管理器。

前言：为什么你需要 Herdr？

你是否遇到过这样的场景：AI 编程助手正在帮你跑一个长任务，你合上笔记本去开会，回来发现进程中断了——一切都要从头再来？或者你同时在多个项目里开了好几个 AI 智能体，切换来切换去，完全搞不清哪个在忙、哪个卡住了、哪个已经跑完了？

Herdr 正是为了解决这些问题而生的。官方文档里有一句话概括得很精准：“Herdr is the runtime your coding agents live on.”——它是你的 AI 编程智能体赖以生存的"运行时环境"。

简单来说，Herdr 是一个终端工作区管理器，专为同时运行多个 AI 编程智能体（如 Claude Code、Codex、Cursor 等）而设计。它的核心理念是：让每个智能体待在一个真实的终端窗格里，shell、日志、提示符和运行中的进程都完好无损。你关闭终端窗口、合上笔记本、甚至重启电脑，它们都不会停——等你回来，一切照旧。

核心概念：一张图搞懂 Herdr 的架构

在动手之前，先理解 Herdr 的五个核心概念：

用一句话串起来：一个会话里可以打开多个工作区（不同项目），每个工作区有多个标签页（不同任务），每个标签页可以分割成多个窗格（多个终端），每个窗格运行一个智能体或其他进程。

官方文档展示了一个典型场景：“三个工作区、四个智能体，其中两个正在执行任务。此刻没有任何人连接着——这才是关键所在。”

第一步：安装 Herdr

安装非常简单，一条命令搞定。官方提供了多平台的安装方式：

macOS (Homebrew)：

1brew install herdr

Linux / macOS (官方脚本)：

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

Windows (PowerShell)：

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

安装完成后，运行 herdr --version 确认安装成功。

第二步：快速上手——鼠标就能搞定

Herdr 对新手极其友好。官方文档明确说："第一次接触终端复用器？上手不需要学习快捷键。Herdr 以鼠标为先：点击窗格、拖动边框、通过右键菜单分割和切换。"

具体操作方式：

• 点击任意窗格即可切换焦点
• 拖动窗格之间的分割线调整大小
• 右键点击弹出上下文菜单，进行分割窗格、创建标签页等操作
• 拖拽选中文本自动复制，双击单词直接复制——完全不需要 Ctrl+C

进入你的项目目录，直接运行 herdr 即可启动：

1cd ~/my-project
2herdr

首次运行会有引导流程（onboarding），跟着走一遍就能完成基础配置。

第三步：启动你的第一个 AI 智能体

在 Herdr 的窗格里启动 AI 编程助手，和普通终端完全一样：

1. 点击你想要运行的窗格
2. 输入启动命令，比如 claude 或 codex
3. Herdr 会自动检测到它，并在侧边栏显示状态

Herdr 支持开箱即用检测的智能体包括：Claude Code、Codex、Cursor Agent CLI、GitHub Copilot CLI、Devin CLI、Kimi Code CLI、Qoder CLI、OpenCode、Pi、OMP 等。

Herdr 会跟踪每个窗格里是否有智能体，并把它们的状态汇总到标签页和工作区。侧边栏会显示三种状态：

• Blocked（阻塞）：智能体在等待你的输入（如权限确认、提问）
• Working（工作中）：智能体正在执行任务
• Done（完成）：任务已完成，等待你审阅

这就是 Herdr 的核心工作流：启动多个智能体，让它们并行工作，用侧边栏看哪个项目需要决策、哪个还在运行、哪个已经可以审阅。

第四步：键盘快捷键（前缀键 Ctrl+b）

虽然鼠标很好用，但掌握快捷键效率更高。Herdr 使用和 tmux 类似的前缀键（Prefix Key）模式，默认是 Ctrl+b。

使用方法：先按 Ctrl+b，松开，再按功能键。

所有快捷键都可以在配置文件中自定义。

第五步：会话状态与恢复——最强持久化

这是 Herdr 最强大的功能。官方文档详细列出了四种恢复路径：

1. 普通分离与重新连接（最强）

当你按下 Ctrl+b q 或直接关闭终端窗口，你只是断开了客户端连接。Herdr 服务器和所有智能体继续运行。重新运行 herdr 就能立刻回到之前的状态——原始进程从未停止。

2. 服务器重启后的快照恢复

如果 Herdr 服务器意外停止后重启，原来的窗格进程虽然不在了，但 Herdr 会恢复保存的会话形态：工作区、标签页、窗格、目录、布局和焦点。每个窗格会在各自保存的目录中作为新的 shell 回来。

3. 窗格屏幕历史回放

服务器完全重启后，如果开启了窗格屏幕历史功能，Herdr 可以恢复最近的终端内容。不过这个功能默认关闭，因为窗格输出可能包含密钥、令牌、提示词等敏感信息。可以在配置文件中开启。

4. 智能体原生会话恢复（最强智能体验）

一些智能体可以恢复它们自己的对话会话。Herdr 使用官方集成上报的会话引用，在服务器重启后自动重新启动受支持的智能体窗格。

支持的智能体及恢复命令包括：

• Claude Code: claude --resume
• Codex: codex resume
• Cursor Agent CLI: cursor-agent --resume
• Pi: pi --session
• Kimi Code CLI: kimi --session
• 以及 OMP、Devin、Droid、Qoder、OpenCode 等

运行 herdr integration status 查看已安装的集成版本。

5. 实时交接（实验性）

用于更新 Herdr 版本时，可以请求旧服务器把实时窗格转移给新服务器，让进程跨服务器替换继续运行。这是实验性功能，需要主动开启。

第六步：配置——按你的习惯来

Herdr 无需配置文件即可使用。当你需要自定义时，再添加配置文件。

配置文件位置可以通过 herdr --help 查看。配置格式为 TOML，修改后可以热重载：

1herdr server reload-config

或通过全局菜单选择「reload config」。

常用配置项

设置默认 shell：

1shell = "zsh"

未设置时，Herdr 会依次使用 $SHELL、/bin/sh 或 PowerShell。

设置 shell 模式：

1shell_mode = "auto"  # 或 "login" 或 "non_login"

auto 模式在 macOS 上会启动登录 shell，让 PATH 等设置生效。

设置新窗格的工作目录：

1new_cwd = "follow"  # 或 "home"、"current"，或指定固定路径

默认 follow 会继承来源窗格或工作区的目录。

自定义按键绑定：

1[keys]
2focus_pane_down = "prefix+j"
3focus_pane_up = "prefix+k"

按键字符串支持 ctrl+a、shift+n、alt+1、cmd+k 等修饰组合键。

Git Worktree 支持

Herdr 内置了 Git worktree 支持：

• New worktree：创建新检出，如果分支已存在则检出，否则创建分支
• Open worktree：列出仓库现有的 Git worktree 检出
• 归组的 worktree 仍像普通工作区一样工作，可以聚焦、重命名、关闭
• 关闭父工作区会关闭整个组，但不会删除检出目录或分支

第七步：API 与自动化

Herdr 提供了强大的 CLI 和本地 socket API，可以从脚本、工具和智能体控制 Herdr。

大多数命令输出 JSON 响应，适合自动化。常用命令包括：

 1# 创建工作区
 2herdr workspace create --cwd ~/my-project
 3
 4# 创建标签页
 5herdr tab create
 6
 7# 分割窗格
 8herdr pane split --right
 9
10# 关闭工作区
11herdr workspace close

完整的 CLI 参考可以在官方文档中找到。

第八步：插件系统——无限扩展

Herdr 的插件系统是其一大亮点。官方文档指出："插件是可分享、可执行的工作流包。插件可以是 Bash 脚本、JavaScript 应用、Lua 脚本、Rust 二进制，或你机器上能运行的任何 argv 命令。"

插件的核心设计理念：让 Herdr 保持精简，核心专注于终端工作区、窗格和智能体；插件把这套扩展面变成可复用的工作流。

安装插件：

1herdr plugin install owner/repo

plugin install 只接受 GitHub 简写，会克隆仓库、在交互式终端展示预览、运行构建命令。

本地开发插件：

1herdr plugin link ./my-plugin

插件通过 herdr-plugin.toml 清单声明动作、事件钩子和链接处理器。运行时，Herdr 会注入一系列环境变量：HERDR_SOCKET_PATH、HERDR_BIN_PATH、HERDR_PLUGIN_ID 等。

示例插件仓库：ogulcancelik/herdr-plugin-examples，包含 agent-telegram-notify、github-link-preview、dev-layout-bootstrap 等示例。

写在最后

Herdr 解决了一个真实而具体的痛点：让 AI 编程智能体真正"活"起来，而不是每次都要重新启动。

无论你是在本地开发、在云服务器上跑任务，还是通过 SSH 远程工作，Herdr 都能让你的智能体持续运行。它的设计哲学很清晰——保持核心精简，通过鼠标和快捷键降低门槛，通过插件和 API 提供无限扩展可能。

如果你正在使用 AI 编程助手，并且厌倦了反复启动、丢失上下文、搞不清任务状态，不妨试试 Herdr。一条命令安装，鼠标点点就能上手，然后让你的智能体们真正"住"下来。

本文基于 Herdr 官方文档整理而成，如需更详细的信息，请访问 herdr.dev/docs 。

相关文章

• 终端三件套：Zellij + Herdr + cmux 打造 AI 编码终极工作流
• Zellij vs rmux：终端复用工具的远程控制与自动化能力深度对比
• 现代终端效率工具全家桶：Yazi、Zellij、Starship 与 Ghostty 深度指南
• Cursor + Claude Code + Codex 三层栈：AI 编程工具的可组合生态