Everything you need to know about herdr
herdr is an agent multiplexer that lives in your terminal. It allows you to manage multiple AI agents simultaneously with real-time terminal views, detach/reattach functionality, and seamless integration with your existing terminal environment.
herdr runs as a single Rust binary in your terminal. It creates a multiplexing layer where you can spawn multiple agents, each in their own pane. Agents can communicate via a pure socket API, spawn additional panes, wait on each other, and maintain state across detach/reattach cycles.
herdr supports any terminal-based AI agent that can communicate through standard I/O. This includes popular agents like Claude, ChatGPT, Gemini, and custom agents. The agent skill system provides a framework for extending agent capabilities.
Yes! herdr runs in whatever terminal you already use - whether it's macOS Terminal, iTerm2, Windows Terminal, or any other terminal emulator. It doesn't require its own terminal environment and integrates seamlessly with your workflow.
Installation is simple:
curl -fsSL https://herdr.dev/install.sh | shYou can also use package managers:
• brew install herdr (Homebrew)
• mise use -g herdr (mise)
• Windows Beta: powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
Detach with Ctrl+B q (or your configured prefix key). Your agents continue running in the background. Reattach later by simply running herdr in any terminal. Sessions survive terminal restarts and can be reattached over SSH.
herdr uses tmux-style prefix keys by default (Ctrl+B). Common shortcuts include:
• Ctrl+B c - Create new pane
• Ctrl+B x - Close pane
• Ctrl+B % - Split vertically
• Ctrl+B " - Split horizontally
• Ctrl+B q - Detach session
Mouse support is also fully enabled for clicking and dragging.
Plugins extend herdr's functionality by adding new pane types and workflows. Browse the marketplace at herdr.dev/plugins to discover available plugins. Installation is typically as simple as adding a configuration entry.
Configuration is handled through a YAML file located at ~/.herdr/config.yaml by default. You can customize key bindings, pane layouts, agent configurations, plugins, and more. Detailed configuration options are documented at herdr.dev/docs/configuration.
Yes! herdr is open source under the GNU Affero General Public License v3.0 (AGPL-3.0). The source code is available on GitHub at github.com/ogulcancelik/herdr.
herdr is dual-licensed:
1. Open source: GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later)
2. Commercial: Commercial licenses are available for organizations that cannot comply with AGPL
Contact hey@herdr.dev for commercial licensing inquiries.
Yes! While the AGPL license allows commercial use, some organizations may prefer a commercial license for additional assurances. Commercial licenses are available directly from the maintainers. Contact hey@herdr.dev for more information.
Contributions are welcome! You can:
• Report bugs or request features on GitHub
• Submit pull requests with improvements
• Help translate the documentation
• Sponsor the project for continued development
See CONTRIBUTING.md for guidelines on how to contribute.
Documentation is available at herdr.dev/docs. For additional help:
• Join discussions on GitHub issues
• Follow @herdrdev on X (Twitter)
• Check the community discussions in the repository
• Contact maintainers at hey@herdr.dev
You can sponsor herdr development directly through GitHub Sponsors at github.com/sponsors/ogulcancelik. Sponsors receive special recognition and benefits depending on their tier. For enterprise partnerships, contact hey@herdr.dev.