用途：herdr 是终端原生的智能体多路复用器，为每个 pane 提供独立终端（shell、智能体、服务器或日志流），并允许从 CLI 控制整个会话。使用前须确认环境变量 HERDR_ENV=1；若未设为 1，应声明自己不在 herdr 管理的 pane 中并停止，不得从外部检查或控制当前聚焦的 herdr pane。
主要能力：查看其他 pane 与智能体的状态；在同一 workspace 内创建 tab 作为子上下文；拆分 pane 并在其中运行命令；在兄弟 pane 中启动服务器、观察日志、运行测试；等待特定输出后再继续；等待其他智能体完成；生成更多智能体实例。herdr 二进制位于 PATH，其 workspace、tab、pane、wait 命令通过本地 Unix socket 与运行中的实例通信。
概念：workspace 是项目上下文，含一个或多个 tab；tab 是 workspace 内的子上下文，含一个或多个 pane；pane 是 tab 内的终端拆分，各自运行独立进程。智能体状态由 herdr 自动检测，公开字段 agent_status 取值为 idle、working、blocked、done、unknown，done 表示已完成但尚未查看。ID 形如 workspace 1、2，tab 1:1、1:2，pane 1-1、1-2，均为当前会话的紧凑公开 ID，关闭后可能压缩，不应视为持久 ID，需要时重新从列表或创建/拆分响应中读取。
常用命令：herdr pane list 查看 pane 与聚焦项；herdr workspace list 列出 workspace；herdr pane read 1-1 --source recent --lines 50 读取屏幕；herdr pane split 1-2 --direction right --no-focus 拆分；herdr pane run 1-3 "npm run dev" 运行命令；herdr wait output 1-3 --match "ready" --timeout 30000 等待文本；herdr wait agent-status 1-1 --status done --timeout 60000 等待智能体完成；herdr pane send-text 与 send-keys 发送文本或按键。pane read 的 source 支持 visible、recent、recent-unwrapped。pane split 输出 JSON，新 pane id 位于 result.pane.pane_id。wait output 支持 --regex，超时退出码为 1。
限制：仅能在 herdr 管理的 pane 内使用；ID 非持久；tab、workspace 管理、pane 关闭、现成配方及 JSON 输出与 ID 解析细节见 REFERENCE.md；原始协议与完整 API 参考见 socket API 文档。其余未在资料中说明。