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 updateStep 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 Debian: 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 Bookworm, Trixie, Forky and Sid
- ✅ 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 Debian 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
- Neovim Editor - Hyperextensible Vim-based editor
💝 Support This Project
If this repository saves you time and effort, please consider supporting it!