herdr

herdr 是由独立开发者 Can Öğülcan 用 Rust 编写的终端原生 AI 编码 Agent 工作区管理器。它的核心定位是：把 tmux 的终端多路复用能力，升级为专门服务于 AI Coding Agent 的指挥控制台。

---

背景：AI Coding Agent 时代的基础设施缺口

2025 年以来，以 Claude Code、OpenAI Codex、Cursor Agent 为代表的 AI 编程工具迅速普及。开发者开始习惯在终端里同时运行多个 Agent——有的在写新功能，有的在修 Bug，有的在跑测试。然而现有终端管理工具存在一个根本矛盾：

tmux 诞生于 AI 出现之前，它不知道也不关心 pane 里跑的是人还是 Agent，更无法告诉你"哪个 Agent 卡住了、哪个在做啥、哪个已经完成了"。你只能自己盯着每个终端窗口看。

GUI 类 Agent 管理器（如 Conductor、cmux、Emdash）解决了状态可见性问题，但它们是独立 App，往往 macOS 限定、需要账号、有遥测数据，而且本质上是"把终端画面重新包装进另一个 App"，无法脱离 GUI 环境运行。

herdr 诞生于 2026 年，正是为了填补这个空白：给 Agent 时代打造的终端工作区管理器。

---

核心能力：Agent 感知的多路复用

真实终端 × Agent 状态感知

herdr 每个 pane 都是一个真正的终端（通过 portable-pty 实现），不是模拟的伪终端。这意味着即使 Agent 运行的是全屏 TUI（如 htop、vim、lazygit），也能完美渲染，不会出现花屏或错位。

更关键的是，herdr 能自动检测 Agent 状态。通过 src/pane/agent_detection.rs 中的检测逻辑，herdr 能识别出 Agent 处于以下哪种状态：

• 🔴 Blocked — Agent 在等待人工确认或遇到无法自动解决的问题
• 🟡 Working — Agent 正在执行任务
• 🔵 Done — Agent 任务已完成
• 🟢 Idle — 空闲状态
• ❓ Unknown — 无法判断

这些状态不需要用户配置任何 hook 或脚本，开箱即用。Agent 检测支持包括 Claude Code、OpenAI Codex、Cursor Agent、Gemini CLI、Devin、Kiro、Kimi Code、OpenCode、pi 在内的大量主流 Agent（详见 src/detect/manifests/ 目录下的 20+ Agent 配置）。

持久化与远程接入

herdr 后台运行一个持久化 server（Unix Domain Socket 通信），断开 SSH 连接不会导致 Agent 被杀死。下次连接时，herdr 命令会自动重新 attach 到之前的会话，工作区布局、Agent 运行状态全部恢复。这解决了远程服务器上跑 Agent 最大的痛点——临时断网导致长任务中断。

鼠标原生的工作区管理

herdr 支持鼠标拖拽创建 pane、split、tab，全程无需记忆快捷键。当然也保留了 tmux 风格的键盘操作（默认 prefix 为 Ctrl+b），键盘爱好者可以无缝迁移。

---

技术架构：Rust + 事件驱动

herdr 的代码库约 3 万行 Rust，采用高度模块化设计：

目录	职责
src/api/	Unix Socket API 服务器，支持外部程序控制 herdr
src/app/	核心应用状态机（AppState、PaneState、Session）
src/pane/	PTY 管理、终端渲染、Agent 状态检测
src/server/	客户端连接、clipboard、通知
src/pty/	跨平台伪终端后端（Linux/macOS/Windows）
src/integration/	各 Agent 的 herdr-agent-state 集成脚本
src/detect/	Agent 进程检测与状态识别
src/workspace/	Git 工作树感知、文件状态

关键技术选型：

• ratatui（v0.30）：Rust TUI 框架，负责侧边栏、tab、pane 等 UI 渲染
• tokio：异步运行时，支撑 API server 和事件订阅
• serde：JSON Schema 验证和序列化
• crossterm：跨平台终端控制
• interprocess + portable-pty：进程间通信和伪终端分配

项目还内置了 Socket API（src/api/），允许外部程序通过 Unix Socket 发送命令来操控 herdr，实现 Agent 对 herdr 的编程控制（如 herdr api pane split --direction=vertical）。

---

安装与上手

herdr 提供极简安装，无需依赖：

# 一键安装（Linux/macOS）
curl -fsSL https://herdr.dev/install.sh | sh

# 或者通过包管理器
brew install herdr
mise use -g herdr
nix run github:ogulcancelik/herdr

# Windows 预览版
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

二进制约 10MB，无 Electron、无 GUI 依赖，安装后直接 herdr 启动。首次启动会创建后台 server 并打开一个空白工作区，在 pane 里运行 Agent 即可。

---

Agent 集成原理

herdr 通过一个巧妙的机制实现 Agent 状态检测：Agent 进程在 pane 内运行时，herdr 会注入一段 agent-state 检测脚本（根据不同 Agent 适配），该脚本通过环境变量 HERDR_SOCKET 连接到 herdr 的 Unix Socket API，实时上报自身状态。herdr server 收到状态更新后，在侧边栏中渲染对应颜色标识。

各 Agent 的集成脚本位于 src/integration/assets/<agent>/herdr-agent-state.sh，用户无需手动配置，只要 Agent 跑在 herdr 的 pane 里，就能自动被发现和监控。

---

局限与争议

1. 无 Web UI：纯命令行工具，不支持浏览器远程访问（虽然可以用 SSH + 手机 terminal 客户端替代）
2. Windows 仍为 Beta：功能完整度不如 Linux/macOS
3. 文档对中文用户不友好：全英文文档，对国内开发者的入门门槛略高
4. 单开发者维护：作者 Can Öğülcan 是独立开发者，无公司背书，长期维护稳定性有待观察

---

行业意义

herdr 的出现折射出一个趋势：随着 AI Coding Agent 普及，专门面向 Agent 的开发工具链正在快速补全。tmux 作为人的终端管理器无法被直接复用，需要重新思考 Agent 场景下的会话管理、状态感知和协作机制。

herdr 目前 GitHub 约 9926 star，2026 年 6 月 30 日曾登顶 GitHub Trending 第一。增长势头强劲，是 AI Developer Tools 领域值得关注的明星项目。