用途：Herdr 将终端组织为工作区、标签页和窗格，能识别窗格中运行的编码智能体，并通过 herdr CLI 暴露当前会话，供检查相邻工作、创建终端布局、启动智能体与命令、读取输出、等待状态变化。
使用前提：任何控制命令前必须先确认当前智能体运行在 Herdr 管理的窗格内，命令为 test "${HERDR_ENV:-}" = 1；失败则说明不在 Herdr 内并停止，不得从 Herdr 外部检查或控制当前会话。通过检查后，PATH 中的 herdr 二进制与当前会话通信。
了解 CLI：以 herdr --help 开始，再分别运行 herdr agent、pane、workspace、tab、worktree、terminal、notification、integration、session 等命令组查看语法。不要直接运行裸 herdr，它会启动或附着 TUI；不要省略参数试探会产生副作用的嵌套命令。多数控制命令返回 JSON，应从中读取标识与状态。
布局与概念：workspace、tab、pane 拓扑组织终端位置；pane 命令控制原始终端、shell、测试、服务器、输入输出；agent 命令控制窗格中已识别的编码智能体。agent start 需要已有可用的 shell 窗格，不会创建、拆分或移动布局。agent 生命周期状态包括 idle、working、blocked、done、unknown；unknown 不代表已完成。
主要命令：herdr workspace list、herdr tab list、herdr pane current --current、herdr pane list、herdr agent list 用于发现状态；创建响应用于获取后续 ID，如 .result.workspace、.result.tab、.result.root_pane、.result.pane。启动智能体可用 herdr agent start reviewer --kind codex --pane <返回的窗格 ID>，原生智能体参数须放在 -- 之后。提交任务用 herdr agent prompt，可用 --wait 与 --timeout；仅特定状态工作流使用 --until。交互控制可用 herdr agent send-keys。普通命令可用 herdr pane split、herdr pane run、herdr pane wait-output、herdr pane read。
安全与协调：除用户要求切换上下文外，后台任务使用 --no-focus；使用 --current、明确窗格 ID 或唯一智能体名，不依赖其他客户端的聚焦窗格；从 JSON 响应解析 ID，不按侧边栏顺序推測；未经用户明确要求，不关闭非自己创建的工作区、标签页、窗格或会话；不在活动会话中运行 herdr server stop，也不杀死主 Herdr 进程。CLI 服务器错误为 stderr 上的 JSON，退出码 1；语法错误退出码 2。
限制：该资料未提供定价、平台支持范围与图形界面等更多信息。