What is herdr?
herdr is an agent multiplexer that lives in your terminal โ a workspace manager for running and orchestrating multiple AI coding agents side by side. Written in Rust and shipped as a single static binary, it lets you drive a whole fleet of agents (Claude Code, Codex, Gemini, Aider and more) from one keyboard-friendly TUI, with persistent sessions, git worktrees and remote access over SSH.
- Run many agents at once โ each in its own pane, tab and workspace
- Persistent sessions that survive disconnects, like a multiplexer for agents
- Git worktree aware โ isolate each agent on its own branch
- Remote over SSH โ attach to a herdr server running anywhere
โก Key Features of herdr
๐ค Multiple Agents Side by Side
Launch and orchestrate several AI coding agents at once, each in its own pane and tab, and switch between them without leaving your terminal.
๐๏ธ Workspaces & Sessions
Group your work into named, persistent sessions and workspaces that keep running in the background and reattach instantly.
๐ฟ Git Worktrees
Give each agent its own git worktree and branch, so parallel work never collides and diffs stay clean and reviewable.
๐ฅ๏ธ Remote over SSH
Attach through SSH to a herdr server running on any machine and drive remote sessions as if they were local.
โจ๏ธ Keyboard-Driven TUI
A fast, mouse-optional terminal UI with configurable keybindings, tabs and panes โ everything is a keystroke away.
๐ Integrations & Extensible
Built-in agent integrations plus a socket API and config file, with a growing ecosystem of first-class plugins around it.
apt upgrade keeps you on the latest version.
๐ฆ Installation from deb.griffo.io
Step 1: Add Repository
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update๐ There is an always-free mirror. deb-free.griffo.io serves packages free forever โ no account, no subscription, at most 2 months behind upstream, security fixes immediately. It currently carries Ghostty, Oh My Posh and Zed; herdr is not one of them, so the repository above is the only way to get it today โ ask and it can be enrolled.
Step 2: Install herdr
# Install latest herdr
sudo apt install herdr
# Verify installation
herdr --version# Install latest herdr
apt install herdr
# Verify installation
herdr --version๐ฏ Basic Usage Examples
Launch and attach to your session:
# Launch or attach to the persistent session
herdr
# Use or create a named session
herdr --session work
# Attach to a named session
herdr session attach workWork with remote servers:
# Attach through SSH to a remote herdr server
herdr --remote user@server
# Open a named session on a remote host
herdr --remote user@server --session buildManage workspaces, worktrees and agents:
# Workspace, worktree and agent helpers over the socket API
herdr workspace list
herdr worktree list
herdr agent list
# Show local client and running server status
herdr statusChannels, config and shell completion:
# Choose the stable or preview update channel
herdr channel set stable
# Generate shell completions for zsh
herdr completion zsh
# Print the default configuration
herdr --default-config๐ Why Choose deb.griffo.io?
- Official Ubuntu: herdr is not packaged โ nothing to install
- Curl / self-updater: Manual setup, updates outside the package manager
- Build from source: Requires a Rust toolchain and time
- deb.griffo.io: Latest version with automatic apt updates
- โ Latest Features: Get the newest agent integrations and TUI improvements
- โ Automatic Updates: Packages updated within hours of upstream releases
- โ No Manual Setup: Pre-built static binary, no Rust compilation needed
- โ Proper Integration: Correctly packaged and installed to /usr/bin
- โ Multi-Distribution: Works on Jammy, Noble, Questing and Resolute
- โ Easy Maintenance: Standard apt commands for updates
๐ Why herdr is Different
- Agent-first: Purpose-built to run many AI coding agents in parallel
- Persistent: Server/client model keeps sessions alive across disconnects
- Git-native: Worktrees keep every agent isolated on its own branch
- Remote-ready: Attach to a herdr server anywhere over SSH
- Single binary: Static Rust build with no runtime dependencies
๐ฆ Package Build Repository
The Ubuntu packages are automatically built and maintained in this GitHub repository:
- ๐ herdr-debian - Latest release builds
๐ Related Packages
Also available from deb.griffo.io:
- Zellij Multiplexer - Terminal workspace multiplexer
- Ghostty Terminal - Fast GPU-accelerated terminal
- lazygit - Simple terminal UI for git
- Neovim Editor - Hyperextensible Vim-based editor
๐ Support This Project
If this repository saves you time and effort, please consider supporting it!