macOS 14 or later, Linux and Windows. Open source, MIT.
Shepherd is not another terminal multiplexer. herdr keeps running your sessions and agents; Shepherd is the window onto them, drawn with GPUI and its own terminal.
The agents list shows every agent herdr detects in any workspace, with its status: working, blocked, done or idle, the task in its title and how long it has waited. Click one to jump to its pane.
When an agent you can't see starts waiting or finishes, macOS shows a notification and the Dock icon counts it until you look. Approve on the notification answers the agent without opening Shepherd.
The sidebar folds a repo's worktrees under it with their branch, changes against main and PR state. Right-click creates, opens or removes one.
Drag tabs to reorder them. Drag a pane by its grip onto another pane to split or swap, or onto a tab to move it there. Dividers snap to herdr's cell grid and the terminal reflows while you drag.
libghostty-vt with Shepherd's glyph renderer: ligatures, Kitty images and box drawing. Scrollback is read from herdr once and scrolled locally. ⌘-click opens links, files, folders and images.
⌥⌘B opens the review panel: the branch's PR (gh) or MR (glab) with its description, checks or pipeline jobs and their logs. It works for SSH machines too.
⌘K opens a command panel with every action, workspace and tab. The status bar shows the branch, its PR and CI, the current folder, the focused agent and your Claude and Codex plan limits.
Sessions and saved SSH machines sit in a bar under the sidebar, as Arc's spaces; a two-finger swipe goes to the next one. Settings cover fonts, themes, key bindings and usage, and edit herdr's own config.toml keeping your comments. Every binding can be changed.
One universal build for Apple silicon and Intel Macs, packages for Linux, a zip for Windows.
macOS 14 or later. Signed and notarized, so Gatekeeper opens it without a prompt. Open the dmg and drag Shepherd to Applications.
x86_64 and aarch64. It draws with Vulkan, so it needs a Vulkan driver (mesa-vulkan-drivers, which the packages recommend). No Dock badge or self-update there; settings live in ~/.config/shepherd.
A zip with the exe. x86_64, and aarch64 when its cross build goes through.
Shepherd for iPhone and Android watches the same herdr session from your pocket: agent status on the lock screen, a push when one needs you, one tap to answer. It is also an SSH and mosh terminal, so it reaches the server with or without herdr. More about it.
Shepherd talks to the herdr server over ~/.config/herdr/herdr.sock, so herdr has to be installed and running. You can point it at another binary or socket in Settings.
One window for herdr's workspaces, tabs, panes and every agent in them. Shepherd is open source and MIT licensed.