herdr
SHA-256herdr 是编码代理的持久化后台运行时:一个常驻终端服务器,让 AI 代理持续工作、断线重连、面板状态一目了然。一个 Rust 二进制,无 Electron,兼具 tmux 的强力与鼠标操作的便利。
给 AI 编码代理安一个常驻后台,终端永远不掉线。
核心功能
- 常驻后台服务,关盖、断网、重启后会话保留,随时重新连接
- 每个面板显示工作中/已阻塞/空闲状态,快速找到卡住的代理
- 代理原生支持:代理可通过 CLI 和 Socket API 创建面板、互相协作
- 兼容 Claude Code、Codex、Cursor、OpenCode 等主流编码代理
- 键盘和鼠标都支持,可点击、拖动、分屏,按需切换
避坑指南
- •不要把它当作通用终端复用器(如 tmux)的完全替代——其核心设计面向 AI 代理和 CLI 工作流,传统终端用户可能还需要 tmux 的更多高级功能。远程持久化功能可能需要额外配置(请参考官网 remote 文档),且 Windows 版本目前处于 Beta 阶段,功能可能不完整。首次使用请先阅读官方文档以了解 Socket API 的安全注意事项。
适用场景
- 让 AI 编码代理在后台长时间运行,你离开电脑后它仍继续干活,回来随时查看进度
- 在 SSH 远程服务器上管理多个编码代理,断开重连后工作现场不丢失
详细介绍
herdr 是一个轻量级后台服务器,为 AI 编码代理和终端工作流提供持久运行的“家”。它运行在你已有的终端里,让 Claude Code、Codex、Cursor、OpenCode 等代理持续工作而不被中断。核心亮点是“代理原生”设计:代理可以通过 CLI 和 Socket API 创建面板、相互提问,并等待其他代理真正卡住时再介入。每个面板都会显示“工作中”、“已阻塞”或“空闲”状态,你再也无需四处寻找卡死的进程。会话在合盖、断网甚至重启后依然保留,可从任意终端或 SSH 重新连接。相比普通 tmux,herdr 同时提供鼠标和键盘操作,并支持插件扩展。整个工具只有一个 Rust 二进制文件,没有任何 Electron 依赖。
标签
快速上手
安装软件
根据你的发行版安装对应的包(dpkg / rpm / AppImage)
执行安装命令 curl -fsSL https://herdr.dev/install.sh | sh 或使用 Homebrew(brew install herdr)
在项目目录启动 herdr,然后运行你的 AI 编码代理
需要离开时按 Ctrl+B 然后按 Q 解除挂载,回来直接输入 herdr 重新连接
- 执行安装命令 curl -fsSL https://herdr.dev/install.sh | sh 或使用 Homebrew(brew install herdr)
- 在项目目录启动 herdr,然后运行你的 AI 编码代理
- 需要离开时按 Ctrl+B 然后按 Q 解除挂载,回来直接输入 herdr 重新连接
已提供 SHA-256 校验码,下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
976150a14d490c94b243ea2e1a7eb2dfb67f12e36b182db90936f6728e6aecf4该校验码提取自 GitHub Release 页面,下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
使用 Homebrew 安装的可以执行 brew uninstall herdr 卸载;使用脚本安装的请删除 herdr 可执行文件(通常在 ~/.local/bin/herdr)及其配置目录(如 ~/.herdr 或 ~/.config/herdr)。卸载后不会残留后台进程。
无额外依赖
下载后即可直接使用,无需安装其他运行环境