面向 AI coding agent 的终端复用器，提供持久化会话、多 agent 并行状态监控与 Socket API 自主编排能力。
herdr 是一款定位为"tmux for agents"的终端复用器，专为 AI coding agent 的并行管理与监控而设计。它在传统终端复用能力（workspace/tab/pane 三级窗口管理、持久化会话、detach/reattach）之上，构建了 agent 状态实时感知体系——侧边栏以四级颜色标识（🔴 blocked / 🟡 working / 🔵 done / 🟢 idle）展示每个 agent 的运行状态，workspace 级别自动汇总最紧急状态。
核心差异化#
- 零配置状态检测：通过前台进程名匹配与终端输出启发式分析即可工作，也支持 Socket API 精确上报
- 完整 Socket API：允许 agent 自主创建 workspace、分割 pane、运行命令、读取输出、等待状态变化，实现 agent-to-agent 协作
- 一键集成安装：内置对 Claude Code、Codex、Amp、OpenCode 等主流 agent 的支持
架构设计#
采用客户端-服务器架构，单 Rust 二进制交付，无外部运行时依赖。后台 session server 保证 detach 后 agent 持续运行，支持 SSH 远程 reattach。通信层基于本地 Unix Socket，涵盖客户端-服务器间及 agent 集成与服务器间的全部交互。
状态检测引擎采用双模式：被动模式通过前台进程名匹配 + 终端输出启发式分析推断状态；主动模式由 agent 通过 socket API 上报语义状态。Agent 状态遵循四级状态机：blocked → working → done → idle。
功能特性#
- 三级窗口管理：workspace → tab → pane，支持水平/垂直分割、全屏切换、resize
- 命名会话：每个命名会话拥有独立的 panes、tabs、workspaces 和状态，共享全局配置
- 鼠标原生支持：点击 pane 切换焦点、拖拽边框调整大小、选中文本复制
- 主题系统：内置 9 套主题（catppuccin、tokyo night、dracula、nord、gruvbox、one dark、solarized、kanagawa、rosé pine）
- 通知系统：声音 + toast 通知，具备 tab 感知的静默机制
- 嵌套兼容：可在 tmux 内运行
安装与使用#
curl -fsSL https://herdr.dev/install.sh | sh
快速上手：
herdr # 启动/附加到默认后台会话服务器
# ctrl+b q 退出客户端（agent 继续运行）
# n 创建新 workspace
# v/- 分割 pane
# c 创建新 tab
# b 切换侧边栏
# f 全屏 pane
Agent 集成安装：
herdr integration install claude
herdr integration install codex
herdr integration install pi
herdr integration install opencode
配置文件路径：~/.config/herdr/config.toml，可通过 herdr --default-config 查看完整默认配置。
适用场景#
- 多 AI coding agent 并行执行不同子任务，统一监控状态
- 服务器/远程开发环境中让 agent 持续运行，随时 SSH 接入
- Agent 通过 Socket API 实现 agent-to-agent 协作与子任务编排
- 以 git 仓库或文件夹为单位的项目级工作区管理
当前支持 Linux 和 macOS 平台，采用 AGPL-3.0 许可证，当前版本 v0.5.4。