跳至内容

Herdr · v0.9.5 · 2026-10

代理放到后台跑,谁在等你一眼看到

Herdr 是给 AI 编程代理用的终端工作区管理器。Claude Code、Codex 这些代理照常在终端里跑,Herdr 不包装也不替换它们,只接管它们所在的终端。关掉窗口或者 SSH 断线,代理照样在跑;哪个代理停下来等你回答,侧栏会标出来;代理之间还能互相派活。

  • Apache 2.0 开源
  • Rust 写的单个程序
  • macOS · Linux · Windows
  • 识别二十多种代理

它在你和代理之间加了一层

客户端你眼前这个终端窗口,可以随时关掉,换台电脑再连

Herdr 后台服务所有终端都归它管,客户端走了照样在跑

工作区

api

blog

infra

api / 标签页 agents

w1:p1 · claudeblocked

要跑一条命令,等你批准

w1:p2 · codexworking

正在改代码…

w1:p3 · just test --watch普通终端

测试在跑,不是代理,所以不标状态

示意图,不是真实截图。w1:p2 这种是 Herdr 的窗格编号:第 1 个工作区的第 2 个窗格。工作区里只要有一个代理卡住,侧栏里这个工作区就会标成 blocked。颜色是本页自己配的。
  • 工作区 workspace

    最上层,一个项目或一件事开一个。侧栏汇总里面所有代理的状态。

  • 标签页 tab

    工作区里的一种布局,比如 agents、logs、server 各占一个。

  • 窗格 pane

    一个真实的终端,可以往右或往下拆分。代理就跑在窗格里。

  • 会话 session

    一套完全独立的后台服务。平时用默认那个就够,工作区优先。

用过 tmux 的人会觉得眼熟,前缀键也是 ctrl+b。没用过也不要紧,它以鼠标为主:点窗格、拖边框、右键菜单拆分,快捷键是可选的。

五种状态,最要紧的是 blocked

  • blocked

    等你回答代理需要你输入、批准一个操作,或者做个决定

  • working

    正在干活

  • done

    做完了,你还没看过

  • idle

    做完了或在等,你已经看过

  • unknown

    判断不出来不代表任务已经成功做完

它怎么知道代理在干什么

默认靠看屏幕。Herdr 先找出每个窗格里跑的是哪种代理,再读窗格最底下正在显示的内容,按这种代理的一套识别规则判断状态。装了官方集成的代理,或者自己支持 Herdr 的代理,改用代理自己上报的状态。状态会从窗格一路汇总到标签页和工作区,所以代理一多,看侧栏就知道该先去哪个。

断开和重启是两回事

断开,再连回来

关掉终端窗口、SSH 断线、按 ctrl+b q 离开

  • 进程一直在跑
  • 布局原样
  • 屏幕内容原样
  • 代理对话接着聊进程从来没停过

后台服务重启

机器重启,或者执行了 herdr server stop

  • 进程没了窗格在原目录重开一个新 shell,测试、开发服务器不会自己回来
  • 布局恢复工作区、标签页、窗格、目录都按存档恢复
  • 屏幕内容默认不恢复打开 pane_history 才有
  • 代理对话装了集成才能接上比如 Claude Code 用 claude --resume 接回原来的对话

屏幕内容默认不存盘,因为窗格里可能出现密钥、token 和提示词。打开 pane_history 以后,Herdr 的配置目录就要像终端历史记录一样小心对待。接回代理对话要先用 herdr integration install claude 这类命令装上对应的集成,这个功能装好后默认开着。

在哪台机器上跑都行

  • 本机

    在项目目录里启动,后台服务自动开好

    herdr
  • 先 SSH 上去,再开

    代理跑在服务器上,用法和 tmux 一样。手机上装个 SSH 客户端也能看,界面会适配窄屏

    ssh you@server 然后 herdr
  • 界面在本机,代理在远程

    本机画界面,用你本机的主题,本机剪贴板里的图片也能粘过去

    herdr --remote workbox
  • 几台机器放进一个窗口

    本机和几台 SSH 机器的代理合在一个列表里,各自断线重连

    herdr machine add <host> --label <label>

代理也能操作它

Herdr 有一套命令行和本地 socket 接口。跑在 Herdr 窗格里的代理可以自己拆窗格、启动别的代理、给它发任务、等它做完再读结果。官方还提供了一份 skill 文件 skills/herdr/SKILL.md,装进 Claude Code 这类代理,它就知道怎么用这些命令。

# 在右边拆出一个新窗格
$ split=$(herdr pane split --current --direction right --no-focus)
$ review_pane=$(printf '%s\n' "$split" | jq -r '.result.pane.pane_id')
# 在新窗格里启动 Codex,起名 reviewer
$ herdr agent start reviewer --kind codex --pane "$review_pane" -- -m gpt-5.4
# 让它审当前的改动,等它做完
$ herdr agent prompt reviewer "Review the current diff" --wait --timeout 120000
# 读它最后 120 行输出
$ herdr agent read reviewer --source recent-unwrapped --lines 120
官方文档 Agent automation 一节里的示例,命令原样摘录,中文注释是本页加的。skill 文件开头有一条护栏:没有环境变量 HERDR_ENV=1,说明代理不在 Herdr 窗格里,就应该停下来,不去操作不属于它的会话。

用之前要知道的五件事

  • idle 不等于可以放行

    blocked 判得故意很严,只认已知的审批、提问和权限界面。代理出了 Herdr 没见过的新提示,可能先显示成 idle。文档专门提醒:idle 不代表你可以批准操作。写脚本按状态自动发输入之前,先读一眼屏幕。

  • 插件不审核,也不隔离

    插件就是在你机器上、以你的身份运行的代码,能调用 Herdr 的全部命令。插件市场自动收录打了 herdr-plugin 标签的公开 GitHub 仓库,不经审核。herdr plugin install 安装前会预览源码和要跑的命令,只装你信得过的作者的。

  • 它会联网更新识别规则

    Herdr 会在后台从 herdr.dev 拉取各代理识别规则的更新,自动生效,不用重启。不想要可以在配置里关掉:[update] manifest_check = false。

  • 想合上笔记本还继续跑,得装在别的机器上

    推断 断开不停,指的是 Herdr 后台服务所在的机器一直开着。装在笔记本上,合盖休眠以后进程也跟着暂停。要让代理通宵干活,就把 Herdr 装在一台常开的服务器上,从笔记本用 SSH 或 herdr --remote 连过去。

  • 网上有些信息已经过时

    许可证最早是 AGPL-3.0 加商业授权的双许可,2026-07-22 改成了 Apache 2.0。仓库从个人账号 ogulcancelik/herdr 搬到了组织 herdrdev/herdr,旧地址会自动跳转。看到说法对不上的文章,先看发表日期。