About herdsman
herdsman is a terminal workspace for running coding agents: workspaces, tabs and panes, SSH-connected machines, agents recognised by their state, and stacked panes.

Based on herdr
Section titled “Based on herdr”herdsman is a modified version of herdr, licensed under the Apache License 2.0. It keeps taking in herdr’s releases: each herdsman release names the herdr release it is built on in the changelog.
What herdsman changes:
- It is a separate app. Every name from herdr is replaced: the
herdsmanbinary, its own config and state directories, its socket, itsHERDSMAN_*environment variables and its agent hooks. herdsman and herdr run side by side on the same machine without sharing anything. - Stacked panes. One layout slot holds several panes and shows one at a time, while the hidden ones keep running.
prefix+alt+cor Stack here in a pane’s right-click menu adds one. - Equal pane sizes.
prefix+|gives every column in a tab the same width andprefix+_every row the same height; a pane’s right-click menu andherdsman tab equalizedo the same. - Worktree sections. A repository’s worktrees can be sorted into named sections, each under its own collapsible header in the sidebar.
- Tab presets. A tab’s layout saved under a name opens again as a new tab in any workspace, from the
prefix+tlist or a tab’s right-click menu, with each pane starting its saved command. - The agent skill comes with the integrations. Installing the Claude Code, Codex or OpenCode integration also installs herdsman’s agent skill, and
herdsman updatekeeps it matched to the new binary. - Updates that respect your package manager.
herdsman updatepoints apt, dnf and pacman installs at their package manager instead of replacing a file it owns. - Its own releases and packages. Versions, the install script, the Homebrew tap, the apt, dnf and pacman repositories and the preview channel are herdsman’s, independent of herdr’s.
herdsman is not affiliated with or endorsed by the herdr project. Problems that also happen in herdr are best reported to herdr: a fix there reaches herdsman with the next merge.
Licences
Section titled “Licences”herdsman is licensed under the Apache License 2.0; LICENSE has the full text and NOTICE the attribution. Every release carries both files next to the binaries, and the Linux packages install them under /usr/share/licenses/herdsman/.
herdsman includes third-party software under its own licences:
| Component | Used for | Licence |
|---|---|---|
| libghostty-vt, from Ghostty | terminal emulation in every pane | MIT |
| portable-pty, from WezTerm | pseudo-terminals | MIT |
| Microsoft ConPTY runtime | pseudo-terminals in the Windows build | MIT |
The Rust libraries herdsman is built from are listed with their licences in Cargo.lock and on crates.io.
Source and contributing
Section titled “Source and contributing”The source is at github.com/remziduzagac/herdsman. CONTRIBUTING.md explains how to report problems and send changes.