herdr

herdrdevApache-2.0活跃维护

给编码 Agent 用的运行时,用 Rust 实现,把 Claude Code、Codex 等命令行 Agent 统一调度和复用,省去自己搭编排层。

the runtime your coding agents live on

v0.9.5发布于 2026-10-14 16:07 UTC49,880star +1,063 / 7 天4,032fork同步于 2026-11-10 11:19 UTC

怎么上手

由 README 提炼,执行前请确认
curl -fsSL https://herdr.dev/install.sh | sh
herdr
硬件要求按 README 说明

README 未说明

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

给编码 agent 用的终端运行时,关掉客户端或断 SSH 也不中断任务

给编码 Agent 用的运行时,用 Rust 实现,把 Claude Code、Codex 等命令行 Agent 统一调度和复用,省去自己搭编排层。

核心能力

  • 后台服务器托管终端,断连后重连恢复布局
  • 多机统一窗口,本地与 SSH 机器合并 agent 列表
  • 每个窗格标记 working/blocked/idle 状态
  • agent 通过 CLI 和 socket API 派生窗格、互相提示
  • 单个 Rust 二进制,无 Electron,跑在现有终端里

容易踩的坑

机器或服务器重启后原进程不会存活,只能恢复布局和受支持的 agent 会话;Windows 有受端点保护环境的单独说明,普通安装脚本可能不适用

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.9.5
  1. v0.9.5最新正式版2026-10-14 · 2026-10-14 16:07 UTC

    This is a hotfix release for v0.9.4. See the v0.9.4 notes for the full feature release: https://github.com/herdrdev/herdr/releases/tag/v0.9.4

    Fixed

    • Prefix shortcuts work again when the terminal sends the next key as plain text. This affected Tern, Chinese, Japanese and Korean input methods on macOS, and Ghostty text: keybinds that send the prefix and a key together. Workspace navigation had the same problem. (#5255)
    • Codex sessions no longer start with a "clamping Interrupt hook timeout" warning. Herdr no longer installs Codex turn hooks, and Codex status comes from screen detection again. Run herdr integration install codex to update. (#5246, #5278)
    • Claude Code questions show as blocked in named sessions. (#4573, #5192)
    • On Windows, plugin panes start even when a folder on PATH has the same name as the plugin's program. (#5267, #5269, thanks @JJLiebig)
    • On Windows, Claude Code session tracking works when the user folder name contains non-ASCII characters, such as Korean. (#5253, #5270, thanks @JJLiebig)
    • Adding a Windows machine no longer prints raw PowerShell progress output. (#4639, #5282, thanks @JJLiebig)
  2. preview-2026-10-14-fbd2ae23927fPreview build 2026-10-14-fbd2ae23927fpre-release2026-10-14 · 2026-10-14 15:43 UTC
    查看更新说明

    Preview build 2026-10-14-fbd2ae23927f

    View changes

  3. v0.9.42026-10-13 · 2026-10-13 15:41 UTC
    查看更新说明

    Added

    • herdr plugin update updates plugins installed from GitHub, all at once or by name. Running plugin panes keep working on their old files, and new runs pick up the update without a config reload. Locally linked plugins are left alone. (#4245, thanks @JJLiebig)
    • Windows notifications stay in Notification Center. Clicking one jumps to its pane and brings the terminal window forward. (#4773, #4803, thanks @JJLiebig)

    Changed

    • An elevated Windows server now only accepts administrator clients by default. To let normal clients from the same account in, set [server] allow_unelevated_clients = true or start the server with --allow-unelevated-clients. Permission errors now say how to fix them, and sessions you can't reach show as unavailable instead of stopped. (#4717, #4769, #4777, #4779, thanks @JJLiebig)
    • On Linux and macOS, closing the shell that started Herdr no longer stops the server. Scripts that stopped Herdr with SIGHUP should use herdr server stop or SIGTERM. The server log now says why the server stopped. (#4920, #4965)
    • With mouse capture on, plugins that handle a link get first pick when you click it. Turn capture off to use your terminal's own link shortcuts, like Command-click on macOS. (#4874, #5064, thanks @JJLiebig)
    • Antigravity and Grok count as idle once they are back at their prompt, even if their own background tasks or subagents are still running. (#3530, #4735, #4959)
    • Ctrl+Shift+letter reaches plain shells as the Ctrl key, like in Alacritty and WezTerm. Super, Hyper and Meta shortcuts no longer type escape-code junk into apps that can't read them. (#4356, #5017)

    Fixed

    • Restarting a Mac or shutting down Windows keeps your agents' sessions. Herdr saves before the system starts closing apps, so agents come back where they were. (#4414, #5013, #5057, #5092, thanks @JJLiebig)
    • Session saves are written to disk before they replace the old file, so a crash or power cut can't leave an unreadable save. (#5150, #5152, thanks @JJLiebig)
    • The server keeps running when the machine runs out of processes or threads, instead of taking every pane down with it. (#3324, #4958)
    • An out-of-range workspace number returns workspace_not_found instead of crashing the server. (#5096, #5171)
    • Suspending an agent with Ctrl+Z and bringing it back with fg keeps its name and saved conversation. (#1647, #4964)
    • Restoring a session stays responsive when a checkout's Git data is slow or missing. Worktree groups survive checkouts that are temporarily unavailable, and opening the same repository twice no longer nests one workspace inside the other. (#4926, #4736, #4945, #4770, #4772, thanks @minatoaquaMK2 and @JJLiebig)
    • Closing a workspace's only pane asks first, like closing its last tab already does. Turn this off with ui.confirm_close = false. (#5143, #5173)
    • Ctrl shortcuts like Ctrl+W work on non-Latin keyboard layouts such as Russian, Greek or Hebrew. Latin layouts and AltGr characters keep their normal meaning. (#1079, #4961)
    • Accent keys and AltGr shortcuts work on Windows. (#4688, #5021, thanks @JJLiebig)
    • Shift+Enter and other enhanced keys keep working after the outer terminal resets, for example after VS Code's Reload Window. (#4985, #5088)
    • Quick Escape taps work on macOS with WezTerm's Kitty keyboard mode. (#1266, #5089)
    • Kitty keyboard apps get key releases and F1, F2 and F4 correctly, and Backspace works when the terminal sends Ctrl+H for it. (#4184, #4403, #3244, #5017)
    • Keyboard and terminal color replies no longer leak stray characters into pane input, and a half-finished color reply no longer freezes typing. (#4856, #4025, #5052, #5017, #5087)
    • Fish no longer repeats prompt fragments while you resize a pane. The same problem with zsh and Powerlevel10k is still open, waiting on a Ghostty fix. (#3672, #4977)
    • Apps that ask for pixel mouse coordinates get them, and clicks land in the right place on terminals that only report cells. (#4750, #3675, #5017, #4971)
    • Turning o
  4. preview-2026-10-12-6d697e1e75ffPreview build 2026-10-12-6d697e1e75ffpre-release2026-10-12 · 2026-10-12 13:48 UTC
    查看更新说明

    Preview build 2026-10-12-6d697e1e75ff

    View changes

  5. v0.9.32026-09-29 · 2026-09-29 19:29 UTC
    查看更新说明

    This is a hotfix release for v0.9.2. See the v0.9.2 notes for the full feature release: https://github.com/herdrdev/herdr/releases/tag/v0.9.2

    Fixed

    • Terminal shortcuts that send Escape followed by a key work again in panes. On macOS, Option+Left/Right and Option+Backspace from Ghostty's defaults or iTerm2's Natural Text Editing preset move and delete by word again, instead of typing b and f or deleting one character. Escape-based Shift+Enter bindings insert a newline in Claude Code instead of submitting. Clicking a pane still doesn't send a stray Escape. (#4751)
    • Alt+[ followed quickly by another key no longer merges into a different key. (#4751)

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    herdr


    https://github.com/user-attachments/assets/043ec09f-4bdd-41d5-aee0-8fda6b83e267

    the runtime your coding agents live on.

    • detach without stopping work — herdr keeps terminals running in a background server when you close the client or lose your SSH connection. after a server or machine restart, herdr restores the saved layout and can resume supported agent sessions; the original processes do not survive. session state →
    • several machines, one window — keep local work and saved ssh machines together, with a combined agent list and independent reconnects. remote machines →
    • never hunt for the stuck one — every pane is marked working, blocked, or idle. when an agent stops and needs an answer, herdr says so.
    • agent-native — agents drive herdr through the cli and socket api: they can spawn panes, prompt each other, and wait until another agent is genuinely blocked. agent skill →
    • runs what you already run — claude code, codex, cursor, opencode, grok and the rest. herdr doesn't wrap or replace them; it owns their terminals. building an agent? add herdr support →
    • keyboard and mouse, both first-class — tmux-style prefix keys and click, drag, split. pick per moment, not per tool.
    • plugins — extend panes and workflows. browse the marketplace →
    • one rust binary, no electron — runs in whatever terminal you already use.

    install

    curl -fsSL https://herdr.dev/install.sh | sh
    

    or brew install herdr · mise use -g herdr · windows: powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex" · endpoint-protected Windows · binaries

    then start it where the work lives:

    herdr
    

    run your agents, split panes, walk away. ctrl+b q detaches, herdr reattaches. quick start →

    docs

    everything lives at herdr.dev/docs: quick start · concepts · supported agents · keyboard · configuration · session state · connecting machines · remote · integrations · add herdr support to your agent · plugins · socket api

    thanks

    every past sponsor and backer is listed in SPONSORS.md — thank you 🐑

    enterprise / partnership: [email protected]

    agent instructions

    if you are an ai agent helping with this repository, read AGENTS.md before making changes and read CONTRIBUTING.md before opening issues or PRs.

    development

    git clone https://github.com/herdrdev/herdr
    cd herdr
    cargo build --release
    
    just test        # unit tests
    just check       # formatting, tests, and maintenance checks
    

    license

    Herdr is licensed under the Apache License 2.0.