herdr-core(hc)
让编码 agent 在可分离、可附着、可跨机器接管的持久终端里运行并互相派活。
- Star 数
- ★ 832
- 最近更新
- 4 天前
- License
- Apache-2.0
- 主语言
- Rust
- FA 评分
- 58/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 长期运行测试或构建(cargo test、bun dev)的开发者:用 hc run --bg 启动后离开,回来用 hc attach 或 hc read 查看进度。
- 不适合
- 希望开箱即用图形界面的人:核心本身不绘制任何界面
- 需要保证终端内已 detach 的后台进程一定被清理的团队
- 依赖 agent 品牌自动识别或屏幕文本推断状态的场景
- 官网
- herdr.dev/core ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-16近 7 天每天 +23.1 ★
- 源码审查
- 58/100 · 缺口较多
这个 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 的文档。
- 长期运行测试或构建(cargo test、bun dev)的开发者:用 hc run --bg 启动后离开,回来用 hc attach 或 hc read 查看进度。
- 编排多 agent 的团队:父 agent 用 hc send 给子 agent 派任务,用 hc wait --children all 收集结果,依赖笔记了解何时需要人工介入。
- 需要跨机器执行任务的工程师:用 hc machine add 注册 SSH 主机,用 hc run --on 在远端运行程序,本地统一查看终端列表。
- 构建自定义前端或 IDE 集成的开发者:通过 hc schema 获取 OpenRPC 接口,用 hc connect 经 stdin/stdout 或 SSH 接入。
- 希望重复使用 agent 角色的用户:按 templates 保存 reviewer 等模板,用 hc run --bg --name review reviewer "..." 快速起一个带角色的终端。
- 不希望被终端窗口绑住的运维/CI 场景:用 hc run --keep 保证即使程序丢失也能恢复一个 shell 继续排查。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
curl -fsSL https://releases.herdr.dev/core/install.sh | sh
- 配置文件
.github/workflows/ci.ymlXDG_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 | shpowershell -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 checkjust installWindows 上模板与带引号的 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?
查看各维度的扣分理由
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。
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。
SKILL.md 明确适用场景(子代理、后台任务、跨机器)与不适用边界(不负责窗口布局,交给 herdr-app),触发条件($HC_TERMINAL_ID、询问一次)较精确,环境适配覆盖 Linux/macOS/Windows 与 SSH,记 2;但 Windows 依赖 sh、模板与引号命令行为差异属未完全消解的适配缺口,未给 3。
README 结构清晰、安装说明完整、示例充分、已知限制(签名条件、状态过期、SIGTERM 不保存设置)写明,LICENSE 为完整 Apache-2.0 且 Cargo.toml 声明一致,记 3;版本与变更方面仅提及 CHANGELOG.md 规则与 v* 标签,包内未见实际 CHANGELOG 内容,记 1;维护责任指向单一维护者 ogulcancelik,发布仅其可执行,明确但单点,记 2。
输出可用性有 JSON/文本区分、hc get/read/wait 等具体接口,记 2;相对 tmux/nohup 的边际价值(子代理编排、状态协议、跨机器)有说明但缺对比基准,记 2;成本收益上安装需 curl|sh、构建需 Zig 与子模块、真实代理冒烟测试花钱,收益论证偏薄,记 1。
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 内容,版本演进可追溯性有限。
常见问题
herdr-core 是图形终端吗?
关闭终端窗口或 SSH 断开后,正在运行的程序会停止吗?
后台进程一定会在终端结束时被清理吗?
agent 的状态是怎么得到的?
能否在没有图形环境或没有 Linux/macOS 的机器上使用?
herdr-core(hc) 官网是什么?
herdr-core(hc) 免费吗?
herdr-core(hc) 开源吗?
herdr-core(hc) 安全吗?
herdr-core(hc) 还在维护吗?
herdr-core(hc) 是谁开发的?
谢谢反馈,我们会据此改进页面。