Skip to content

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.

herdsman: a repository’s worktrees sorted into sections in the sidebar, and an editor beside a stack of three agent panes

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 herdsman binary, its own config and state directories, its socket, its HERDSMAN_* 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+c or Stack here in a pane’s right-click menu adds one.
  • Equal pane sizes. prefix+| gives every column in a tab the same width and prefix+_ every row the same height; a pane’s right-click menu and herdsman tab equalize do 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+t list 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 update keeps it matched to the new binary.
  • Updates that respect your package manager. herdsman update points 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.

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.

The source is at github.com/remziduzagac/herdsman. CONTRIBUTING.md explains how to report problems and send changes.