herdr

Summary

Herdr is an open-source runtime that hosts coding agents within it. It is available under the Apache 2.0 license and operates as a background server accessed via a command-line tool. This system is designed for development teams working with agent workflows, positioning it as a container for existing agent interactions like Claude or Codex. The product documentation describes it in the space of session management tools that handle persistent, multi-agent terminal sessions. The project maintains regular updates, with active links provided for documentation and installation.

the runtime your coding agents live on

Command line

Values are placeholders taken from each option’s declared default. Nothing is executed here — the output shown is a recording of a run that already happened.

Release history

1. v0.8.2 Aug 19, 2026 · issue 004

   herdr v0.8.2 adds Windows GA, Qwen Code support, remote attach, new config keys for window titles, tab bar status, and pane resize bindings

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v0.8.2 https://github.com/herdrdev/herdr.git
   # already have the repo? check out this version:
   $ git checkout v0.8.2

   └──▷ USE IT
   Keep your terminal emulator's tab bar and window manager title bar showing the active Herdr workspace and host.
   ~/.config/herdr/config.toml copy

   # ~/.config/herdr/config.toml
   ui.window_title = true

   Resize the focused pane instantly from the keyboard without entering resize mode — useful in keyboard-driven workflows.
   ~/.config/herdr/config.toml copy

   # ~/.config/herdr/config.toml
   [keys]
   resize_pane_left  = "ctrl+h"
   resize_pane_down  = "ctrl+j"
   resize_pane_up    = "ctrl+k"
   resize_pane_right = "ctrl+l"

   • ›Adds ui.window_title config key to keep the outer terminal window title in sync with the active workspace and host across window managers and tab bars.
   • ›Adds ui.pane_outer_borders config key to independently show or hide the outside edges of split-pane borders.
   • ›Adds ui.status_indicators = "symbols" setting to use distinct static shapes for blocked, working, done, idle, and unknown agent states.
   • ›Adds theme.custom.sidebar_bg config key to give the desktop sidebar its own background color without changing built-in theme defaults.
   • ›Adds theme.custom.selection_bg config key for a dedicated per-theme cursor color in Navigate-mode selection rows.
   +11 moreshow less

   • ›Adds optional keys.move_tab_previous and keys.move_tab_next bindings to reorder the active tab in place, wrapping at either end.
   • ›Adds optional keys.resize_pane_left, keys.resize_pane_down, keys.resize_pane_up, and keys.resize_pane_right bindings to resize the focused pane in one keystroke without entering resize mode.
   • ›Windows clients can now use herdr --remote to attach to Herdr servers on Linux and macOS.
   • ›Panes can now route right-click gestures to mouse-reporting applications via the pane menu, herdr pane input, pane.input.set, or the pane split --right-click pane launch option.
   • ›Adds Qwen Code detection for idle, working, and user-confirmation states, plus optional native session restore.
   • ›The desktop tab bar now supports configurable right-aligned status entries for zoom state, hostname, date/time, literal text, and asynchronously refreshed command output.
   • ›Copy mode now supports B, E, and W motions over whitespace-delimited big words.
   • ›Cursor Agent CLI, MastraCode, Hermes Agent, and Grok CLI integrations now install and run natively on Windows.
   • ›Windows support is now generally available through stable releases, using the stable update channel by default.
   • ›Headless servers now use a configurable 120×40 virtual terminal (up from 80×24) when no client is attached.
   • ›The plugin marketplace now discovers valid manifests at repository roots and subdirectories, groups multiple plugins per repository, and publishes their versions and exact default-branch commits.
2. preview-2026-08-18-9fac51722653 Aug 18, 2026 · issue 004

   herdr preview adds Windows general availability and plugin marketplace discovery shelves.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch preview-2026-08-18-9fac51722653 https://github.com/herdrdev/herdr.git
   # already have the repo? check out this version:
   $ git checkout preview-2026-08-18-9fac51722653

   • ›Makes Windows support generally available, including installer and keybinding support.
   • ›Adds plugin marketplace discovery shelves — trending and new arrivals — for browsing available plugins.
3. preview-2026-08-17-1147e60bc0a4 Aug 17, 2026 · issue 004

   herdr preview adds configurable headless terminal size, pane resize keybinds, tab-bar status, per-pane right-click routing, and Windows agent support.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch preview-2026-08-17-1147e60bc0a4 https://github.com/herdrdev/herdr.git
   # already have the repo? check out this version:
   $ git checkout preview-2026-08-17-1147e60bc0a4

   └──▷ TRY IT
   Observe a remote herdr session at a fixed terminal geometry — useful for headless CI agents that need a predictable screen size.
   copy

   $ herdr terminal session observe <target> --cols 220 --rows 50

   • ›Adds configurable headless terminal size, enabling unattended agent runs at a defined column/row geometry.
   • ›Adds direct pane resize keybindings for keyboard-driven layout control without prefix chords.
   • ›Adds configurable tab bar status display.
   • ›Makes outer pane borders configurable.
   • ›Adds per-pane right-click routing so right-click events can be directed to specific panes.
   +10 moreshow less

   • ›Supports all agent integrations on Windows, closing the gap between Windows and Unix agent workflows.
   • ›Adds direct pane frame streaming for lower-latency terminal output delivery.
   • ›Adds move-tab keybind actions for reordering tabs from the keyboard.
   • ›Adds big-word motion support in the terminal editor.
   • ›Supports remote attach to Unix hosts, allowing herdr sessions to be reached over SSH.
   • ›Adds distinct status indicators for pane/agent state.
   • ›Adds optional sidebar background styling.
   • ›Adds Qwen code detection and session restore.
   • ›Keeps the outer terminal window title in sync with the active session.
   • ›Indexes marketplace manifests and tracks star history for trending and new plugin surfaces.
4. v0.8.0 Aug 3, 2026 · issue 004

   herdr v0.8.0 adds --skill flag, new config keys for UI layout, Grok/Antigravity session restore, and workspace.move_block API.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v0.8.0 https://github.com/herdrdev/herdr.git
   # already have the repo? check out this version:
   $ git checkout v0.8.0

   └──▷ TRY IT
   Print the agent skill embedded in the binary so an AI agent can load it into context without fetching external docs.
   copy

   $ herdr --skill

   Reclaim the scrollbar column and move the tab bar to the bottom for a denser terminal layout.
   ~/.config/herdr/config.toml copy

   ui.pane_scrollbars = false
   ui.tab_bar_position = "bottom"

   Resume a detached Grok CLI session by ID after reconnecting to a long-running herdr server.
   copy

   $ grok --resume <id>

   • ›Adds herdr --skill flag to print the agent skill bundled with the running binary.
   • ›Adds ui.pane_scrollbars = false config key to hide terminal pane scrollbars and reclaim their reserved column.
   • ›Adds ui.tab_bar_position = "bottom" config key to place the desktop tab row below terminal panes.
   • ›Adds HERDR_PROCESS_DETECTION=child-groups environment variable to opt Linux runtimes without terminal foreground process groups into child-group agent detection.
   • ›Adds workspace.move_block API method and workspace.reordered event, enabling atomic worktree-group reordering.
   +5 moreshow less

   • ›Adds Grok CLI session reporting and native restore via grok --resume <id>.
   • ›Adds Antigravity CLI session reporting and native restore via agy --conversation <id>.
   • ›Adds live filtering to the keybind help overlay using /, Backspace, and Ctrl+U.
   • ›Adds automatic text history reads for idle alternate-screen agents, with the application viewport restored after collection.
   • ›Windows preview downloads now bundle Herdr and a modern app-local ConPTY runtime in a single archive.
5. preview-2026-07-29-44b3adb12552 Jul 29, 2026 · issue 004

   Adds grok CLI integration for native session restore and keybind help filtering in this preview build.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch preview-2026-07-29-44b3adb12552 https://github.com/herdrdev/herdr.git
   # already have the repo? check out this version:
   $ git checkout preview-2026-07-29-44b3adb12552

   • ›Adds grok CLI integration (herdr integration) for native session restore, enabling grok agent sessions to persist and reattach like other supported agents.
   • ›Adds filter support to keybind help display, letting users search or narrow the keybind reference in the UI.
   • ›Prints bundled agent skill and next CLI steps on startup to guide agents and users toward herdr --skill and related entry points.
   • ›Switches IME to ASCII automatically in prefix mode on Windows (Korean IME), improving keyboard input reliability for non-US layouts.
   • ›Publishes versioned release documentation alongside each release.