TL;DR
What is Herdr? Herdr is an open-source terminal multiplexer built specifically for the age of AI coding agents. Think tmux, but every pane knows whether its agent is working, blocked, done, or idle — and agents can drive the multiplexer back through a socket API.
It hit 13,900+ GitHub stars and 4,500 new stars this week (July 2026), landing in the top 5 trending repos. Built in Rust, distributed as a single binary, now Apache-2.0 licensed (it was AGPL-3.0 when this review was written), and installable with Homebrew or a one-liner curl.
What changed as of November 2026
- Re-checked November 17, 2026: the current release is still v0.9.5 (October 14, 2026; no newer release or preview build published since), the license is still Apache-2.0, and the repository has ~51,500 stars (up from ~44,900 in October). Meta’s Muse Code now also reports its own state to Herdr, per the supported-agents page (the docs moved under
herdr.dev/tui/docs/).
What changed as of October 2026
- License: Apache 2.0, not AGPL. Herdr was relicensed under Apache-2.0 on July 22, 2026, two weeks after this review. The AGPL caveats below are historical; there is no copyleft obligation and no separate commercial license is needed.
- New home: the repository moved from
ogulcancelik/herdrto herdrdev/herdr (old links redirect). - Version: current release is v0.9.5 (October 14, 2026), a hotfix for v0.9.4; this review was written against v0.4.0. Stars: ~44,900 (from 13.9K in July).
- v0.9.0 (September 7) added managing local and saved SSH machines from one Herdr window (
herdr machine) with a combined agent list, independent multi-client views of different workspaces, and pane images enabled by default in compatible terminals. - More agents: the supported-agents list now also covers Qwen Code, Letta Code, Grok CLI, Antigravity CLI, Amp, Kiro CLI, Maki and Muse, and some agents (Command Code, Crush, Kiro CLI, Prime Agent) report their own state to Herdr. Gemini CLI and Cline remain “state only, less tested”.
- Codex status comes from screen detection again since v0.9.5 (Herdr stopped installing Codex turn hooks); re-run
herdr integration install codexto update.
Why the sudden popularity? If you’ve been running Claude Code in one tmux pane, Codex in another, and a third agent waiting on review feedback, you’ve felt the pain Herdr solves natively.
Key facts:
- Persistent sessions — detach and agents keep running. Reattach from any terminal or over SSH.
- Real agent state — Herdr detects what each agent is doing and surfaces blocked, working, done, and idle status across all workspaces.
- Both keyboard and mouse — tmux-style prefix keys plus click, drag, split, and context menus. No trade-off.
- Socket API — agents can spawn panes, read output, wait on each other, and split terminals.
- Plugin marketplace — extend workflows beyond the built-in features.
- One Rust binary, no Electron — runs in whatever terminal you already have.
- Homebrew install in one command, plus Homebrew, mise, and direct binary downloads.
If you’re a developer running coding agents daily and still using tmux (or no multiplexer at all), Herdr is the tool that brings both worlds together.
Quick Reference
| Field | Value |
|---|---|
| Repo | herdrdev/herdr (formerly ogulcancelik/herdr) |
| Website | herdr.dev |
| Docs | herdr.dev/docs |
| License | Apache-2.0 (since July 22, 2026; AGPL-3.0 before) |
| Language | Rust |
| Install | brew install herdr or curl -fsSL https://herdr.dev/install.sh | sh |
| Current version | v0.9.5 (Oct 14, 2026; reviewed on v0.4.0) |
| Stars | ~51,500 (Nov 17, 2026; ~44,900 in Oct; 13,900 at review time) |
The Problem Herdr Solves
Coding agents have changed how we work, but our terminal multiplexers have not.
If you run Claude Code to refactor a backend, Codex for frontend work, and a third agent iterating on docs, you’re probably using tmux with three windows. It works, but tmux has no idea what the foreground process is doing. Is the agent typing? Waiting for approval? Stuck on a permission prompt? You have to check each pane manually.
The community noticed. On Hacker News (287 points, front page this week), the top comment thread compared Herdr to tmux and Zellij. The consensus: tmux persists terminals, but Herdr persists agent workspaces and understands their state.
“Herdr is a purpose-built answer to a problem that tmux was never designed to solve.” — AI Weekly
The question is not whether a tool can run terminals. The question is whether it combines terminal-native persistence with semantic agent state and agent-driven automation.
How It Works
Architecture
Herdr runs as a background server process that owns persistent PTY sessions. When you run herdr, it either launches or attaches to your default session. The server keeps running after you detach, and agents in its panes keep running too.
Each session contains workspaces (project-level containers), workspaces contain tabs, and tabs contain panes. Herdr detects which panes contain coding agents and rolls their state up the hierarchy so the sidebar shows you what needs attention at a glance.
herdr server (background daemon)
└── session (persistent PTY runtime)
├── workspace "project-a"
│ ├── tab "backend"
│ │ ├── pane 1 [Claude Code — working]
│ │ └── pane 2 [shell]
│ └── tab "frontend"
│ └── pane 1 [Codex — blocked]
└── workspace "project-b"
└── tab "docs"
└── pane 1 [pi — done]
Installation
# macOS (Homebrew)
brew install herdr
# Linux / macOS (direct)
curl -fsSL https://herdr.dev/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
# or use mise
mise use -g herdr
# or download binaries from GitHub releases
That’s it. One binary, no npm install, no Electron, no runtime dependencies.
Quick Start
# Start Herdr in your project directory
herdr
# Herdr opens with an empty workspace. Start an agent:
claude
# The sidebar shows the agent's state. Split the pane:
# (mouse: right-click → split vertically)
# (keyboard: ctrl+b v for vertical split, ctrl+b - for horizontal)
# Open another tab:
# ctrl+b c
# Start another agent there:
codex
# Detach (agents keep running):
# ctrl+b q
# Reattach from anywhere:
herdr
Agent State Detection
This is Herdr’s killer feature. The sidebar shows:
- Working (green) — agent is actively processing
- Blocked (yellow) — agent is waiting on input, approval, or permission
- Done (gray) — agent completed its task
- Idle (dim) — agent is running but not doing anything
Detection works through two systems:
1. Lifecycle hooks (for agents with deep integrations): pi, OMP, Kimi Code CLI, Hermes Agent, OpenCode, Kilo Code CLI, MastraCode. These agents report their state directly to Herdr.
2. Screen manifest detection (for all other agents): Claude Code, Codex, Cursor Agent CLI, GitHub Copilot CLI, Devin CLI, Qoder CLI, Droid. Herdr reads the live bottom-buffer screen snapshot and matches known UI patterns for approval prompts, permission questions, and idle states.
Blocked detection is deliberately conservative for screen-manifest agents — only matching known visible approval or question UI. If Herdr doesn’t recognize a new prompt pattern, it falls back to idle.
You can install native integrations for richer state tracking:
herdr integration install claude
herdr integration install codex
herdr integration install copilot
herdr integration install devin
herdr integration install opencode
FAQ
What is Herdr?
Herdr is a free, open-source (Apache-2.0) terminal multiplexer written in Rust and built for running several AI coding agents at once. Like tmux it keeps persistent sessions you can detach from and reattach to, including over SSH; unlike tmux it knows whether the agent in each pane is working, blocked, done or idle, shows that in a sidebar, and exposes a socket API so agents can open panes, read each other’s output and wait on each other. It supports Claude Code, Codex, GitHub Copilot CLI, Cursor Agent CLI, OpenCode and about twenty other agents. As of November 17, 2026 the current version is v0.9.5, installed with brew install herdr or the install script at herdr.dev.
How is Herdr different from tmux?
tmux persists terminals. Herdr persists agent workspaces and understands agent state. tmux has no concept of “blocked” or “working” — it’s just panes with running processes. Herdr detects the foreground agent, reads its state from the screen buffer (or lifecycle hooks), and surfaces status across all workspaces. It also adds a socket API that agents can use to create panes, split, read output, and wait on each other. Under the hood, Herdr takes a similar approach to tmux (C vs Rust), but the feature set is agent-native from day one.
Can I use Herdr without any agents?
Yes. Herdr works as a general-purpose terminal multiplexer similar to tmux or Zellij. Its keyboard bindings, mouse support, session persistence, and split panes all work without an agent. The agent features are additive — you get a good multiplexer either way, and if you start using coding agents later, Herdr already knows what to do.
Which agents are officially supported?
Claude Code, Codex, pi, OMP, GitHub Copilot CLI, Devin CLI, Kimi Code CLI, Hermes Agent, Qoder CLI, Droid, OpenCode, Kilo Code CLI, MastraCode, and Cursor Agent CLI — and, as of October 2026, also Qwen Code, Letta Code, Grok CLI, Antigravity CLI, Amp, Kiro CLI, Maki and Muse, while Command Code, Crush, Kiro CLI, Muse Code (added by November 2026) and Prime Agent report their own state. Gemini CLI and Cline are detected but less thoroughly tested. Any terminal-based agent still runs as a multiplexer — you just won’t get automatic state badges without an integration.
Can I use Herdr over SSH?
Yes. Herdr sessions are persistent and can be detached and reattached from any terminal. Run herdr on your remote server, start your agents, detach, and reattach over SSH from your local machine. The herdr --remote workflow supports direct connections to specific workspaces.
How does the AGPL license affect me?
It no longer does: since July 22, 2026 Herdr is licensed under Apache-2.0, so you can use, modify and embed it, including in proprietary products, under ordinary permissive terms. The original answer, for versions released before that date: Herdr was AGPL-3.0 for open-source use. If you used it as an individual developer or within your company without distributing modifications, AGPL doesn’t impose new obligations. If your organization needs to embed or modify Herdr in a proprietary product, commercial licenses are available by contacting [email protected].
How It Works in Practice
Not run by us: there is no recorded test of Herdr in our lab, so this section describes what the project’s README and docs state, not a measured run.
Setup is one command. The README gives brew install herdr or curl -fsSL https://herdr.dev/install.sh | sh; you then run herdr where the work lives and start claude, codex or another agent in a pane.
Keyboard and mouse are both first-class, per the README: tmux-style prefix keys and click, drag and split.
Blocked is the most useful signal. Every pane is marked working, blocked or idle, and when an agent stops and needs an answer, Herdr says so — so you can work in one pane, glance at the sidebar, and see which project needs attention without scrolling through every terminal.
The socket API is the underrated feature. Agents can call Herdr’s socket API to create new workspaces, split panes, read output from other panes, and wait on agent completion. This enables multi-agent workflows where one agent delegates to another and waits for the result — all managed through the same multiplexer.
Performance
Herdr ships as one Rust binary with no Electron and runs inside whatever terminal you already use (README). We have not measured its memory, CPU or startup time.
What It Lacks Compared With tmux
tmux kill-session -a— no quick way to kill all sessions- Built-in buffer management — tmux’s copy mode is more mature
display-panesvisual selector — Herdr’s pane navigation relies more on sidebar clicking- Tiling window management (tmux’s
select-layout even-horizontal) — Herdr has manual splitting but fewer automatic layouts
These are gaps, not dealbreakers. Herdr was at v0.4.0 when this review was written (it is on v0.9.5 as of October 2026; these specific gaps have not been re-checked) and the development pace is aggressive (multiple releases per week).
Community & Ecosystem
The Herdr community has already built a plugin marketplace with extensions for workflows, pane management, and integrations. The socket API has been picked up by the OpenCode and Kilo Code teams for native Herdr support.
On Reddit, discussions in r/coding_agents and r/coolgithubprojects noted the speed of development:
“Watching this project grow is impressive. Two weeks ago it was a basic tmux clone with agent labels. Now it has lifecycle hooks, remote sessions, and a plugin system.” — r/coding_agents
The project is built full-time by Oğulcan Çelik and sponsored through GitHub Sponsors. The AGENTS.md file in the repo gives explicit instructions for AI coding agents contributing to the project — a signal that Herdr takes its own philosophy seriously.
Limitations & Honest Concerns
-
Pre-1.0 maturity. Herdr is new (v0.4.0 at review, v0.9.5 in October 2026, still no 1.0). Expect rough edges, missing features, and the occasional breaking change. The rapid release cadence is a double-edged sword — features arrive fast, but config stability is not guaranteed.
-
Blocked detection is conservative. For screen-manifest agents, Herdr only marks blocked when it recognizes a known approval UI pattern. New or unusual prompts may show as idle instead of blocked. This is safe (no false positives for “needs input”), but it means the state awareness is not perfect.
-
AGPL licensing friction. (Resolved — relicensed to Apache-2.0 on July 22, 2026.) At review time some organizations’ blanket AGPL bans would have ruled it out; that no longer applies.
-
Plugin ecosystem is young. The marketplace has a handful of plugins. Compare this to tmux’s decade-plus plugin ecosystem (tpm, tmuxinator, tmux-resurrect, etc.) and the gap is significant.
-
No Windows GUI integration. Windows support exists via PowerShell installer, but the experience on Windows Terminal is less polished than native terminal multiplexers like ConEmu or Windows Terminal’s built-in panes.
Verdict
Herdr solves a real problem that existing tools ignore. If you run even one coding agent regularly in the terminal, the agent state awareness and session persistence alone justify the switch. If you run multiple agents across multiple projects, Herdr becomes a genuine productivity multiplier.
Skip it if: you only use one agent or you have no interest in terminal multiplexers. (The AGPL concern from the original review is gone since the July 2026 Apache-2.0 relicense.)
Install it if: you run Claude Code, Codex, or any coding agent in the terminal and want to know — at a glance — what each agent is doing without checking every pane manually.
What to watch for: The v1.0 release. If the plugin ecosystem grows and blocked detection becomes more comprehensive, this will be the default terminal multiplexer for AI-era developers.
When to Use What
| Tool | Best for |
|---|---|
| Herdr | Multiple coding agents, agent state awareness, SSH-accessible persistent sessions |
| tmux | Established workflows, complex custom configs, plugin-rich ecosystems, any terminal process |
| Zellij | Modern terminal workspace with a friendlier UX, no agent focus needed |
| Warp | macOS users who want an all-in-one agentic development platform |
| Solo | Dev-stack supervision and process health with auto-restart |
| Conductor/Emdash | Git worktree and diff review workflow isolation |
Sources
- Herdr GitHub Repository — Source code, README, documentation
- Herdr releases — v0.9.5, v0.9.0
- Herdr LICENSE (Apache-2.0) — relicense commit dated July 22, 2026
- Herdr supported agents (re-read November 17, 2026)
- Herdr Official Docs — Quick start, agent integrations, configuration
- Herdr Compare Page — Official comparison with tmux, Zellij, cmux, Warp, and others
- Hacker News Discussion (287 points) — Community reactions to Herdr
- AI Weekly: Herdr Adds Agent-State Awareness — Coverage of Herdr’s agent-native approach
Last verified: November 17, 2026.