Multiplex AI agents in persistent terminal sessions
herdr is a terminal-based agent multiplexer that runs multiple AI coding agents in detachable panes you can reattach to from anywhere.
Why it matters
Run multiple AI agents simultaneously in a terminal multiplexer that persists sessions across disconnects and restarts, enabling agents to coordinate work through a socket API while providing real-time visibility into each agent's status and output.
Outcomes
What it gets done
Monitor multiple agent processes in split terminal panes with live status updates
Detach and reattach to running agent sessions from any terminal or SSH connection
Enable agents to spawn panes, read output, and coordinate through socket API
Extend agent workflows with plugins from the marketplace
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/ogulcancelik-herdr | bash Overview
Herdr
herdr is a Rust, no-Electron terminal agent multiplexer that runs multiple AI coding agents in real, detachable terminal panes, reattachable from any terminal or over SSH with sessions surviving restarts, plus a socket API letting agents spawn and coordinate their own panes. Use it when running several AI coding agents concurrently and wanting one detachable, reattachable terminal-native view of all of them; it's AGPL-3.0-licensed with a commercial option, and Windows support is still in beta.
What it does
herdr is an agent multiplexer that lives in your terminal: it runs multiple AI coding agents in real terminal panes - not a wrapped interpretation of their output - so you can see at a glance which agent is blocked, working, or done. Sessions detach and keep running in the background; you can reattach from any terminal, including over SSH, and sessions survive restarts. It's a single Rust binary with no Electron, running in whatever terminal you already use, and supports both keyboard-driven, tmux-style prefix keys and first-class mouse interaction (click, drag, split) - pick whichever fits the moment.
Agents themselves can use herdr too, through a pure socket API that lets an agent spawn its own panes, read their output, and wait on other panes to finish - useful for agent-to-agent coordination without a human in the loop for every step. herdr's functionality extends through a plugin system for custom panes and workflows, browsable in an online marketplace.
When to use - and when NOT to
Use herdr when you're running several AI coding agents concurrently and want a single terminal-native view of all of them - detachable, reattachable from anywhere, and survivable across restarts - rather than juggling multiple terminal windows or tmux sessions manually. It's a fit for anyone who wants agents themselves to be able to spawn and coordinate additional panes programmatically via the socket API, or who wants to extend the multiplexer itself through plugins.
It's licensed AGPL-3.0-or-later (with a commercial license available for organizations that can't comply with AGPL), so organizations with AGPL restrictions should evaluate the commercial option before adopting it. Windows support is explicitly in beta.
Inputs and outputs
Install with a one-line script, Homebrew, mise, or (on Windows, beta) a PowerShell installer, then start it in the directory where the work lives:
curl -fsSL https://herdr.dev/install.sh | sh
herdr
Input is your running AI coding agents inside herdr-managed panes plus keyboard/mouse or socket-API commands to split, spawn, or coordinate panes. ctrl+b q detaches from a session; running herdr again reattaches. Output is the live, real terminal view of every managed agent's state and output, persisted across detach/reattach and restarts.
Integrations
herdr integrates with AI coding agents through its socket API (documented as an agent skill) so agents can programmatically manage panes, and with the terminal environment directly since it's a native binary rather than a wrapped or embedded terminal. It supports a plugin marketplace for extending panes and workflows, and documents specific supported agents and remote/persistence integrations at herdr.dev/docs.
Who it's for
Developers running multiple AI coding agents in parallel who want one terminal-native, detachable, reattachable view of all of them - including remote work over SSH - and teams or agent builders who want agents to coordinate with each other programmatically through a socket API rather than only through human-driven terminal switching.
Source README
herdr
herdr.dev · install · quick start · docs · sponsors
English · 简体中文
https://github.com/user-attachments/assets/043ec09f-4bdd-41d5-aee0-8fda6b83e267
agent multiplexer that lives in your terminal.
- every agent at a glance - blocked, working, done. real terminal views, not a wrapped interpretation.
- detach, agents keep running - reattach from any terminal, or over ssh. sessions survive restarts.
- agents can use herdr too - a pure socket api: agents spawn panes, read output, wait on each other. agent skill →
- keyboard and mouse, both first-class - tmux-style prefix keys and click, drag, split. pick per moment, not per tool.
- plugins - extend panes and workflows. browse the marketplace →
- one rust binary, no electron - runs in whatever terminal you already use.
install
curl -fsSL https://herdr.dev/install.sh | sh
or brew install herdr · mise use -g herdr · windows beta: powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex" · binaries
then start it where the work lives:
herdr
run your agents, split panes, walk away. ctrl+b q detaches, herdr reattaches. quick start →
docs
everything lives at herdr.dev/docs: quick start · concepts · supported agents · keyboard · configuration · session state · remote · integrations · plugins · socket api
sponsors
herdr is built full-time, in the open. sponsoring directly funds development, stability, and the path to a real agent runtime.
gold
→ become a sponsor · enterprise / partnership: hey@herdr.dev · see SPONSORS.md for tiers. thank you 🐑
agent instructions
if you are an ai agent helping with this repository, read AGENTS.md before making changes and read CONTRIBUTING.md before opening issues or PRs.
development
git clone https://github.com/ogulcancelik/herdr
cd herdr
cargo build --release
just test # unit tests
just check # formatting, tests, and maintenance checks
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.