herdr-core(hc)

让编码 agent 在可分离、可附着、可跨机器接管的持久终端里运行并互相派活。

Star 数
★ 832
最近更新
4 天前
License
Apache-2.0
主语言
Rust

30 秒速览

运行形态
命令行工具自托管服务
可在哪里用
通用 · 跨平台
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
RustZig 0.16justsh(Windows,需在 PATH 中)Shell / 命令行网络访问本地文件系统
典型场景
长期运行测试或构建(cargo test、bun dev)的开发者:用 hc run --bg 启动后离开,回来用 hc attach 或 hc read 查看进度。
不适合
  • 希望开箱即用图形界面的人:核心本身不绘制任何界面
  • 需要保证终端内已 detach 的后台进程一定被清理的团队
  • 依赖 agent 品牌自动识别或屏幕文本推断状态的场景
官网
herdr.dev/core ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-16近 7 天每天 +23.1 ★

这个 Agent 能做什么,适合哪些场景?

herdr-core(命令名 hc)是一个终端与进程编排工具:它在后台运行程序或编码 agent,关闭查看端不会结束程序,之后可以随时 hc attach 接管或 hc read 读取输出。核心本身不渲染任何界面,通过 CLI、agent 自身或自建客户端调用。它支持 agent 启动子 agent、用 hc send 发送任务、用 hc wait --children all 等待、用父子笔记回报状态;状态来自程序主动上报的 OSC 7501(Program Status Protocol),核心不做屏幕识别。通过 hc machine add 与 hc run --on 可以把终端延伸到 SSH 远程机器,本地核心统一列出。对外提供 OpenRPC + JSON Schema 接口(hc schema)和 hc connect 的 stdin/stdout 协议通道,便于自建客户端或经 SSH 转发。

hc 接收命令行程序(如 cargo test、bun dev)或模板定义的 agent 角色,在持久会话中启动它们并保留终端输出缓冲区。hc run 前台流式输出并等待,--bg 后台返回,--keep 在程序丢失后由新 shell 恢复(不重跑任务)。hc ls 列出存活终端,hc attach 附着并以 Ctrl+\ 分离,hc read --lines N 读取输出,hc get 取快照,hc events 跟踪变化。agent 在终端内启动的子进程成为其子节点,可用 hc send 回报、hc wait --children all 等待、--outlive-parent 延长生命周期;父级会在子级需要关注或结束时收到笔记。默认等待 180 秒后自动 check in,draft_wait 与 notes_quiet 控制发送前的草稿等待。hc machine add / hc run --on 跨 SSH 机器调度,程序与文件留在远程。hc schema 输出 OpenRPC 接口,hc connect 用 stdin/stdout 承载协议,hc --skill 一次性打印给 agent 的文档。

  1. 长期运行测试或构建(cargo test、bun dev)的开发者:用 hc run --bg 启动后离开,回来用 hc attach 或 hc read 查看进度。
  2. 编排多 agent 的团队:父 agent 用 hc send 给子 agent 派任务,用 hc wait --children all 收集结果,依赖笔记了解何时需要人工介入。
  3. 需要跨机器执行任务的工程师:用 hc machine add 注册 SSH 主机,用 hc run --on 在远端运行程序,本地统一查看终端列表。
  4. 构建自定义前端或 IDE 集成的开发者:通过 hc schema 获取 OpenRPC 接口,用 hc connect 经 stdin/stdout 或 SSH 接入。
  5. 希望重复使用 agent 角色的用户:按 templates 保存 reviewer 等模板,用 hc run --bg --name review reviewer "..." 快速起一个带角色的终端。
  6. 不希望被终端窗口绑住的运维/CI 场景:用 hc run --keep 保证即使程序丢失也能恢复一个 shell 继续排查。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • curl -fsSL https://releases.herdr.dev/core/install.sh | sh
配置文件
.github/workflows/ci.yml XDG_CONFIG_HOME/herdr-core/config.toml
安装说明涉及
Windows · macOS · Linux

如何安装或部署这个 Agent?

Linux 与 macOS 使用官方安装脚本;Windows 使用 PowerShell 脚本。构建覆盖 Linux/macOS 的 x86_64 与 aarch64,以及 Windows x86_64;Linux 构建为静态链接。

curl -fsSL https://releases.herdr.dev/core/install.sh | sh
powershell -c "irm https://releases.herdr.dev/core/install.ps1 | iex"

从源码构建需要 Rust、Zig 0.16 与 just,CI 在 .github/workflows/ci.yml 中固定 Rust 版本:

git submodule update --init --depth 1
cargo build --locked -p herdr-core
just check
just install

Windows 上模板与带引号的 shell 命令需要 PATH 中有 sh(例如 Git for Windows 提供的)。

如何使用这个 Agent?

安装后直接用 hc 运行程序;无程序参数时 hc run --bg 会启动默认 shell(Unix 上为 $SHELL 或 /bin/sh,Windows 上优先 PowerShell 7)。

hc run cargo test                  # stream output and wait for it
hc run --bg --name web bun dev     # start it and return
hc ls                             # see live terminals
hc attach web                     # take over; Ctrl+\ detaches
hc read web --lines 100            # read without attaching

默认 shell 与草稿等待可在配置文件中设置(Windows 为 %APPDATA%\herdr-core\config.toml,或设置 $XDG_CONFIG_HOME 时用 $XDG_CONFIG_HOME/herdr-core/config.toml):

shell = ["nu"]
# Windows Git Bash (literal strings keep backslashes):
# shell = ['C:\Program Files\Git\bin\bash.exe', '--login', '-i']
notes_quiet = 3 # seconds of quiet before a parent note
draft_wait = 60 # seconds a draft holds sends and notes; 0 keeps only the quiet pause

给 agent 提供文档与角色模板:

hc --skill
hc templates
hc run --bg --name review reviewer "Review src/x.rs. Read-only."
hc send review "Focus on the error path."
hc read review --lines 100

跨机器使用:

hc machine add my-ssh-host --name box
hc run --on box --cwd /srv/app cargo test
hc attach box/t3

自建客户端时读取 OpenRPC 接口:

hc schema
hc connect
hc update

这个 Agent 有哪些优点和局限?

优点
  • 终端持久化:关闭查看端后程序继续运行,hc attach 可随时接管,hc read 可非侵入式读取。
  • agent 间协作有明确原语:hc send、hc wait --children all、父子笔记、--outlive-parent,且不依赖屏幕文本猜测。
  • 状态由程序通过 OSC 7501(Program Status Protocol)主动上报,核心不做品牌识别,语义清晰。
  • 跨机器能力基于 SSH 与自定义连接,本地核心统一列出所有终端。
  • 对客户端友好:hc schema 输出 OpenRPC + JSON Schema,hc connect 可用 stdin/stdout 承载协议。
局限
  • 核心不绘制任何界面,必须自带 shell 或自建客户端才能可视化使用。
  • 在 Unix 上结束终端只挂断前台作业,nohup/setsid 分离的后台进程可能继续占用端口,清理语义有边界。
  • 模板与带引号的 shell 命令在 Windows 上依赖 PATH 中的 sh(如 Git for Windows),并非纯原生体验。
  • 配置保存有约束:三分钟后过期,Linux/macOS 不能跨启动继承;普通 SIGTERM 不保存设置。
  • 文档中的示例替代不了实际地址:attach 需使用 run 返回的地址,示例中的 box/t3 并非通用可用的终端名。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
herdr-core(hc) 当前 58 · 缺口较多 命令行工具免费 ★ 832 4 天前 Rust —
tlbx 浏览器终端多路复用器 73 · 存在缺口 自托管服务免费 + 模型费 ★ 119 今天 C# Codex · Claude Code
TUIOS 终端工作空间 74 · 存在缺口 命令行工具免费 ★ 6.6k 今天 Go —
cmux 79 · 表现良好 桌面应用免费版 + 付费版 ★ 29k 今天 Swift Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
58/ 100 五分制 2.9 / 5
信任安全 14/29
可靠稳定 8/14
适用触发 12/18
规范维护 12/18
有效结果 7/13
证据核验 5/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

docs/security.md 明确说明 core 以账户权限运行、不是沙箱、无按客户端鉴权,Unix socket 0700、Windows 命名管道限本账户与 SYSTEM,属诚实披露但权限模型本身宽泛,故 least_privilege 仅 1;用户确认方面,SKILL.md 要求会话内询问一次是否使用 hc,但运行命令、更新、重启等破坏性动作无逐次确认,rollback 仅靠 --keep 与 holder 保活,无通用撤销,均记 1;数据流透明(状态目录、socket、远程信任、更新校验)与敏感数据处理(提示终端输出可能含密钥、状态不加密)写得较清楚,记 2;依赖安全有 cargo-deny、锁定工具链、固定 action SHA 与第三方许可清单,但未见具体漏洞审计结果,记 2;来源归属在 AGENTS.md 与 README 中说明 Ghostty 上游来源与许可,记 2。

可靠稳定8 / 14 · 2.9/5

README 与 SKILL.md 对 wait 超时、draft_wait、first_message.sent、spawn_failed 等失败语义描述一致且具体,failure_messages 记 2;self_consistency 大体一致,但 SKILL.md 片段被截断、部分行为(如 reverse send 超时)依赖配置组合,记 2;依赖可用性方面需 Rust、Zig 0.16、just、子模块与网络安装脚本,Windows 还需 sh 与 ConPTY,门槛偏高且未提供离线方案,记 1。

适用触发12 / 18 · 3.3/5

SKILL.md 明确适用场景(子代理、后台任务、跨机器)与不适用边界(不负责窗口布局,交给 herdr-app),触发条件($HC_TERMINAL_ID、询问一次)较精确,环境适配覆盖 Linux/macOS/Windows 与 SSH,记 2;但 Windows 依赖 sh、模板与引号命令行为差异属未完全消解的适配缺口,未给 3。

规范维护12 / 18 · 3.3/5

README 结构清晰、安装说明完整、示例充分、已知限制(签名条件、状态过期、SIGTERM 不保存设置)写明,LICENSE 为完整 Apache-2.0 且 Cargo.toml 声明一致,记 3;版本与变更方面仅提及 CHANGELOG.md 规则与 v* 标签,包内未见实际 CHANGELOG 内容,记 1;维护责任指向单一维护者 ogulcancelik,发布仅其可执行,明确但单点,记 2。

有效结果7 / 13 · 2.7/5

输出可用性有 JSON/文本区分、hc get/read/wait 等具体接口,记 2;相对 tmux/nohup 的边际价值(子代理编排、状态协议、跨机器)有说明但缺对比基准,记 2;成本收益上安装需 curl|sh、构建需 Zig 与子模块、真实代理冒烟测试花钱,收益论证偏薄,记 1。

证据核验5 / 8 · 3.1/5

AGENTS.md 要求“只报告观察到的”,状态仅来自 OSC 7501 不猜测屏幕,claim_traceability 与 fact_inference_separation 较好,记 2;README、SKILL.md、security.md、CI 之间相互印证(更新保活、签名条件、测试隔离),cross_source_corroboration 记 2;但无独立测试执行证据,且安装脚本与发布清单未在包内,无法完全核实,未给 3。

风险与缓解建议
  • core 以账户权限运行且无按客户端鉴权,任何能连接其 socket 的进程等同拥有该账户的 shell 权限;不要以 root/管理员运行,也不要把 socket 转发给不可信方。
  • 安装与更新通过 curl|sh 与 HTTPS 清单加 SHA-256 校验,但清单无独立签名;Windows 构建在签名配置缺失时为未签名,macOS 仅在默认发布服务下强制团队签名。
  • 状态目录不加密,终端输出与保存的屏幕可能含密钥;会话(HC_SESSION)不是安全边界。
  • 添加远程机器会把本地客户端接入远端账户的命令与文件,并复制可执行代码到远端;需信任目标主机与自定义连接命令。
  • 构建依赖 Rust、Zig 0.16、just 与子模块,Windows 还需 sh 与 ConPTY,离线或受限环境安装成本较高。
  • 发布仅由单一维护者触发,包内未见实际 CHANGELOG 内容,版本演进可追溯性有限。
证据充分度:低 评估于 2026年11月12日 审查版本 55e44c6bd829 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/herdr-core.svg?lang=zh)](https://followagents.com/zh/agents/herdr-core)
<a href="https://followagents.com/zh/agents/herdr-core"><img src="https://followagents.com/badge/herdr-core.svg?lang=zh" alt="FARS 评测"></a>

常见问题

herdr-core 是图形终端吗?
不是。核心本身不绘制任何界面,你需要从 shell、agent 或自建客户端调用;hc schema 与 hc connect 提供了构建客户端所需的协议。
关闭终端窗口或 SSH 断开后,正在运行的程序会停止吗?
不会。关闭查看端不会结束程序;默认 180 秒后 run 会 check in 并打印终端地址,你可以回来用 hc read 或 hc attach 继续。用 hc run --keep 还可以在程序丢失后恢复 shell,但恢复只会启动新 shell,不会重跑任务。
后台进程一定会在终端结束时被清理吗?
在 Unix 上,结束终端会挂断前台作业,但用 nohup 或 setsid 故意分离的程序可能继续运行,包括后台服务器。非预期的 holder 丢失会借助继承的清理令牌结束被遗弃的程序;Windows 使用 job-object 清理。
agent 的状态是怎么得到的?
由程序主动通过 OSC 7501(Program Status Protocol)上报工作、完成、阻塞或出错状态,核心只存储上报内容,不做屏幕文本识别。不上报状态就没有状态。
能否在没有图形环境或没有 Linux/macOS 的机器上使用?
构建覆盖 Linux、macOS 的 x86_64/aarch64 与 Windows x86_64。Windows 上模板和带引号的 shell 命令需要 PATH 中有 sh,例如 Git for Windows 提供的那种。
herdr-core(hc) 官网是什么?
herdr-core(hc) 的 GitHub 仓库填写的官网是 https://herdr.dev/core。这个链接由仓库作者设置;源码在 GitHub(herdrdev/herdr-core)。
herdr-core(hc) 免费吗?
免费。herdr-core(hc) 可以免费使用,不需要付费服务。
herdr-core(hc) 开源吗?
开源。源码在 GitHub(herdrdev/herdr-core),许可证是 Apache-2.0。
herdr-core(hc) 安全吗?
FollowAgents 的 FARS 评审(2026年11月12日)给 herdr-core(hc) 的“信任与安全”打了 14/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
herdr-core(hc) 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-16,在最近 30 天内。
herdr-core(hc) 是谁开发的?
herdr-core(hc) 由 GitHub 账号 herdrdev 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念