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 logo

安装与上手

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 里，就能自动被发现和监控。

局限与争议

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

行业意义

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

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

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

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