What herdsman adds
herdsman is built on herdr and keeps taking in its releases, so what herdr does, herdsman does too. This page lists what herdsman adds on top, each with the herdsman release it arrived in and the page that covers it in full. Anything not listed here works as it does in herdr; a problem with it is best reported to herdr, and a fix there reaches herdsman with the next merge. About herdsman says how the two relate.
Coming from herdr
Section titled “Coming from herdr”- It is a separate app. The
herdsmanbinary,~/.config/herdsman, its socket, itsHERDSMAN_*environment variables and its agent hooks all carry herdsman’s name. herdsman and herdr run side by side on the same machine and share nothing: herdsman reads its own config, and its sessions are its own. 0.1.0 - Agent integrations are installed again for herdsman.
herdsman integration install claude(or another agent) sets up the hooks that report to herdsman; herdr’s own integrations keep reporting to herdr. See Integrations. 0.1.0 - Plugins written for herdr work. A plugin manifest may give
min_herdr_versioninstead ofmin_herdsman_version, and herdsman checks it against the herdr release it is built on, whichherdsman --versionprints on its second line. See Plugins. 0.1.0
Panes and tabs
Section titled “Panes and tabs”Stacked panes
Section titled “Stacked panes”One layout slot holds several panes and shows one at a time, while the hidden ones keep running with their scrollback, working directory and agent state. prefix+alt+c, or Stack here in a pane’s right-click menu, adds a pane behind the current one; a strip along the slot names the members and switches between them. herdsman pane stack and its sibling commands do the same from scripts and agents. See Stacks. 0.1.0
Equal pane sizes
Section titled “Equal pane sizes”prefix+| gives every column in a tab the same width and prefix+_ every row the same height, each leaving the other dimension alone. A pane’s right-click menu offers the same, and herdsman tab equalize width|height does it from the CLI. See Tabs in the CLI reference. 0.1.0
Tab presets
Section titled “Tab presets”A tab’s layout saved under a name opens again as a new tab in any workspace, from the prefix+t list or a tab’s right-click menu, with each pane starting its saved command, such as an agent. A preset can declare parameters, such as a PR number, that it asks for when it opens and hands to every pane as environment variables. See Tab presets. 0.3.0
Workspaces from a preset
Section titled “Workspaces from a preset”A new workspace or worktree can start from a tab preset instead of a plain shell. Creating one shows a preset choice with the default from your config selected, set for every workspace, every worktree, or per repository in [presets]; --preset does the same from the CLI. See Start a workspace from a preset. 0.4.0
Sidebar
Section titled “Sidebar”Worktree sections
Section titled “Worktree sections”A repository’s worktrees can be sorted into named sections, each under its own header in the sidebar that collapses on a click, with Section… in a worktree’s right-click menu or herdsman workspace section. A collapsed section still shows a focused worktree, and its header shows the section’s most urgent agent state. See Worktrees. 0.1.0
Collapsible agents panel
Section titled “Collapsible agents panel”The agents panel collapses to its header, so the spaces list gets the sidebar’s height: click its title or press prefix+a. [ui] agent_panel_start_collapsed = true starts it collapsed. See Collapse the agents panel. 0.3.0
Agents
Section titled “Agents”The agent skill comes with the integrations
Section titled “The agent skill comes with the integrations”Installing the Claude Code, Codex or OpenCode integration also installs herdsman’s agent skill for that agent, so it knows how to drive herdsman, and herdsman update keeps those copies matched to the new binary. A skill herdsman did not write, such as a link into a dotfiles checkout, is left alone. 0.1.0
Themes
Section titled “Themes”More Tokyo Night themes
Section titled “More Tokyo Night themes”tokyo-night-storm and tokyo-night-moon join tokyo-night and tokyo-night-day, and switch to Tokyo Night Day in light mode. All four take their colours from the official tokyonight.nvim palettes. See Theme. 0.3.0
Installing and updating
Section titled “Installing and updating”Its own releases and packages
Section titled “Its own releases and packages”herdsman has its own versions, install script, Homebrew tap, signed apt, dnf and pacman repositories, mise and Nix installs, and a preview channel for upcoming changes. See Install. 0.1.0
Updates that respect your package manager
Section titled “Updates that respect your package manager”herdsman update and the in-app update notice point apt, dnf and pacman installs at their package manager instead of replacing a file it owns. See Update. 0.1.0
Update without restarting
Section titled “Update without restarting”The app offers to update and hand the server off to the new binary, so pane processes and agents keep running, and then comes back on the new version by itself. It also offers a handoff after a package manager upgrade, and updates outdated agent integrations. With [update.auto] handoff = true, the server does all of it on its own at a quiet moment. See Update without restarting. 0.4.0