Herdr

项目简介

Herdr 是面向编码 agent 的运行时。它把终端运行在后台服务器中，组织多个 agent 与项目，并允许你在不中断工作的情况下分离客户端。它支持本地与通过 SSH 连接的机器，并将 agent 标记为工作中、受阻或空闲，让等待输入的 agent 清晰可见。

核心功能

• 分离而不停止工作：关闭客户端或 SSH 连接断开时，终端仍在后台服务器中继续运行。多机一窗：本地工作与已保存的 SSH 机器并列显示，共享 agent 列表并支持独立重连。Agent 状态跟踪：窗格标记为工作中、受阻或空闲，Herdr 会提示停止并需要回答的 agent。Agent 原生控制：agent 可通过 CLI 与 socket API 驱动 Herdr，拆分窗格、互相提示，并等待另一个 agent 真正受阻。兼容现有 agent CLI：Claude Code、Codex、Cursor、opencode、Grok 等运行在 Herdr

适用场景

• 在多个项目中同时运行多个编码 agent，而无需一直打开终端客户端；从另一台机器返回同一批 agent 工作区，并重新接入正在运行的终端；监控一组 agent，找出受阻且需要输入的某个 agent；通过 CLI 与 socket API 自动化 agent 之间的工作流。

快速开始

• 可使用 curl 安装脚本安装，也可通过 brew install herdr、mise use -g herdr、Windows PowerShell 安装脚本或已发布二进制安装。在工作所在位置运行 herdr 启动，运行 agent 并拆分窗格，之后用 ctrl+b q 分离，再用 herdr 重新接入。

部署与要求

• 支持的操作系统为 macOS、Linux 和 Windows。Herdr 以单个 Rust 二进制运行，不使用 Electron，可在你现有的终端中运行。后台 Herdr 服务器持有终端，使客户端能够分离并重新连接。Windows 提供受端点保护的安装选项，也可通过 Homebrew、mise、安装脚本和已发布二进制安装。

采用前须知

• 许可证：Apache-2.0。在使用、修改或分发项目前，请确认其具体条款。