Herdr Review: The tmux Alternative Built for AI Coding Agents

Herdr is a free Apache-2.0 terminal multiplexer that shows which AI coding agents are working or blocked. Setup, limits, and how it compares to tmux.

Herdr review graphic: Herdr terminal multiplexer shown as a tmux alternative built for AI coding agents
November 8, 2026Research-based reviewTerminal tools11 min read

Research note: this is a research-based guide, not a hands-on test. I did not install or run Herdr for this article. There are no affiliate links in it, and the section near the end lists exactly where the evidence came from.

Herdr is a free terminal multiplexer for people who run several AI coding agents at once. It works like tmux, but it recognizes agents such as Claude Code and Codex running in its panes and shows whether each one is working, blocked, done or idle. If you spend your day flipping through terminal tabs to find the agent that needs an answer, that sidebar is the whole pitch, and the reviews and walkthroughs I read say it does that job well. If you run one agent at a time, you probably don’t need it.

My verdict, from the evidence

Herdr solves a real and annoying problem, the “which tab needs me” problem, and it does so without asking you to leave your terminal. It’s free and needs no account. The risk is maturity, not cost.

Herdr suits people juggling several coding agents, and few others

Use it if
  • You run three or more coding agents at once, across repos or machines, and lose track of which one is waiting on you.
  • You work on a VPS or a second computer over SSH and want agents to keep running after your laptop closes.
  • You want agents to open panes, start other agents and read each other’s output through a CLI and socket API.
Skip it, or wait, if
  • You run one agent at a time. An ordinary terminal tab already does that job.
  • You need floating panes or tiling layouts. One comparison of terminal multiplexers lists Herdr’s layouts as splits, tabs, workspaces and zoom, with no floating panes.
  • You want a long-established tool. Herdr is pre-1.0 software, and its plugin ecosystem is young next to tmux’s.

My verdict is built from the evidence I reviewed rather than my own testing. The research section near the end is specific about that.

Herdr organizes work into workspaces, tabs and panes, then labels each agent

The layout has three levels. A workspace usually maps to one repo or project, tabs sit inside a workspace, and panes sit inside tabs. According to one technical write-up, every pane is a real terminal (a PTY) running a shell or an agent, and Herdr renders it with a vendored Ghostty terminal engine. It is a single Rust binary of roughly 10 to 11 MB, with no account and, per the same reviews, no telemetry.

The part that separates it from tmux is the agent layer. Herdr matches the process name in each pane against agents it knows, then reads the terminal output and applies per-agent rules to work out what the agent is doing. The sidebar then shows one of four states, as TecMint describes them:

StateWhat it means
workingThe agent is generating output or running a tool
blockedThe agent is waiting for your input or a permission
doneThe task finished and the agent is sitting at a prompt
idleNo supported agent is running, or the shell is idle

Some write-ups also mention an “unknown” state for panes Herdr can’t classify. For most agents, detection needs no setup. For tighter reporting, herdr integration install <agent> adds lifecycle hooks so the agent tells Herdr its state directly instead of Herdr guessing from the screen.

How many agents count as supported depends on which source you read. One review lists 12 official integrations, another says 14 or more agents work out of the box, and the v0.9.0 release notes name Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Antigravity and Devin, among others. The safe summary is “more than a dozen, including the big names,” and the current docs are the place to confirm yours.

A limitation that matters for trust
A status light is only as good as the rule behind it. A comparison of Herdr’s alternatives notes that blocked-state detection is deliberately strict, so when no rule matches a prompt, Herdr falls back to idle. A pane showing idle can occasionally mean “Herdr didn’t recognize this prompt.”

Setup takes a few minutes, and the prefix key will feel familiar

Install methods reported across the official site and reviews:

  • Linux and macOS install script: curl -fsSL https://herdr.dev/install.sh | sh. As with any script piped into a shell, read it first or use a package manager instead.
  • Homebrew: brew install herdr
  • mise: mise use -g herdr
  • Nix: a flake is available; check the repository for the current command.
  • Windows: a PowerShell installer at herdr.dev/install.ps1. A later changelog read by one reviewer marks Windows as generally available from version 0.8.2 (August 19, 2026), so early reviews calling it a beta are out of date, though Windows still has platform-specific limits.
  • From source: cargo build --release, which needs a Rust toolchain.

Run herdr --version afterward. TecMint says the script installs without root and that you may need ~/.local/bin on your PATH. Updates differ by install method: herdr update works only for script installs, while Homebrew and mise users upgrade through those tools.

Herdr borrows tmux’s prefix model. Press Ctrl+b, release it, then press the next key. These are the bindings I’d learn first, collected from TecMint and from the walkthrough video supplied for this article:

After Ctrl+bWhat it does
qDetach. Panes and agents keep running
v or -Split the pane vertically or horizontally
cNew tab
Shift+NNew workspace
wSwitch workspaces
gGo to any workspace or agent, with status filters
/Search sessions by name or content
sOpen settings (sound, toasts, themes)
?Show every shortcut

In the walkthrough, the g overlay is where the status filters pay off: d narrows the list to finished agents, b to blocked ones, w to working ones, i to idle ones and a shows everything. Keybindings change between releases of a pre-1.0 tool, so treat ? inside Herdr as the authority.

The walkthrough also shows a first launch that offers to install integrations for the agents it finds on the machine, then asks about toasts, sounds and a theme. Mouse support is real: clicking, dragging borders and right-click menus all work, per Bitdoze’s review.

If you try only one thing
Try the persistence test from that video. Start something long-running in a pane (a ping works), press Ctrl+b then q, then run herdr again. The process should still be running. That single check tells you whether the core idea works on your setup.

Agents can drive Herdr themselves, which is where the upside gets interesting

Everything Herdr does is exposed through a JSON API on a local Unix socket, and the herdr command-line tool wraps the same API. Bitdoze’s review describes what that allows: an agent can create panes, run commands in them, read their output and wait for another agent’s state to change. A script can do the same thing. Here is the shape of it, adapted from an example in a technical write-up:

herdr pane split 1-2 --direction right --no-focus
herdr pane run <new-pane-id> "npm run dev"

The new pane’s ID comes back in the JSON that the first command prints.

To make this usable by an agent without you writing glue code, Herdr ships an agent skill, a plain-text instruction file that teaches an agent how to use the API. According to the project’s changelog as collected by Gradually, herdr --skill has printed the skill bundled with the running binary since version 0.8.0 (August 3, 2026). An agent that has read it knows it is inside Herdr and can open panes, start other agents and report back.

The walkthrough video supplied for this article shows what that looks like in practice, and these are the presenter’s results, not mine:

  • A Claude Code session asked to “open five panes” does so on the spot.
  • The same session is told to launch Codex, Grok, Antigravity and a second Claude Code session in an even grid, then have each write a different ASCII-art scene. It does, answers the permission dialogs that appear in those panes, and collects the results as each agent finishes. The presenter notes Grok was the slowest.
  • A request to build a small project with Gemini, Claude and Codex in separate Git worktrees produces three worktree workspaces that show up in the sidebar.

Two things are worth separating here. The capability is real and documented: panes, commands, output reads and state waits are all in the API. The quality of the orchestration, meaning whether the parent agent coordinates sensibly, depends on the agent and model you put in charge, and a demo built around ASCII art says little about that.

The permissions question
Agents launched this way run with your user account’s permissions, and Herdr adds no sandbox. An agent that can start other agents can start more things that can act on your files and network. That is a design choice to make deliberately, not a default to click through.

Remote machines work over plain SSH, but “survives a restart” has fine print

Herdr runs as a background server with a terminal client attached to it. Closing the client, or losing your connection, leaves the server and its panes running. Version 0.9.0 (September 7, 2026) went further and removed the single-process mode, so every launch now attaches to that background server.

Two remote workflows exist:

  • Thin client: herdr --remote ssh://you@server attaches your local Herdr to a server running elsewhere. You keep your local keybindings, and the agents run on the remote machine. A saved name such as herdr --remote workbox skips retyping the URL, per TecMint.
  • Saved machines (0.9.0 and later): herdr machine add workbox --label "Build machine" stores an SSH target, and that machine’s workspaces and agents then appear in the same sidebar as your local ones. The official docs list the conditions: ordinary SSH access must already work, each saved profile targets one remote session, and passphrase-protected keys need ssh-add first. Herdr does not copy local plugins, configuration or secrets to the remote host, and saved profiles store no passwords or private keys.

The walkthrough video shows this with a second computer added by label and address. Its notifications arrive in the same window, and one agent on the local machine messages an agent on the remote one through the CLI. That cross-machine control is newer than the sidebar: the project’s own announcement post said at launch that the agent CLI still worked within one server, and the changelog adds herdr --machine for controlling saved machines in version 0.9.1 (September 16, 2026).

The same post describes a planned service called Herdr Cloud, meant to link machines without you configuring SSH, with end-to-end encrypted terminal traffic. It was not part of 0.9, the post gives no pricing, and a waitlist is the only thing I found. Nothing about it should factor into a decision today.

What actually survives

The video’s closing demo stops the Herdr server entirely, relaunches it, and every agent session comes back. That is accurate for agents, with a caveat. Flavio Copes’s comparison says Herdr restores the workspace layout and can resume supported agent conversations, but arbitrary processes, such as a dev server, restart as fresh shells. An agent resumes because its conversation can be reloaded. A ping or a build does not come back mid-run. Zellij, by contrast, has built-in session resurrection that can restore commands and optionally scrollback.

Against tmux and Zellij, Herdr wins on agent awareness and loses on maturity

Tmux and Zellij see terminals. Herdr tries to see the agent inside the terminal. Everything else in the comparison follows from that one difference, plus the fact that tmux has a roughly 18-year head start.

HerdrtmuxZellij
Knows if an agent is working or blockedYesNoNo
Mouse useBuilt inNeeds configurationBuilt in
LayoutsSplits, tabs, workspaces, zoomScriptedDeclarative layouts, floating panes
After the server exitsRestores layout, resumes supported agent conversationsDoes not checkpoint live processesBuilt-in session resurrection
Several SSH machines in one windowYes, since 0.9NoNo
Extending itLocal executable plugins, young ecosystemConfig, scripts, hooksWebAssembly plugins
MaturityPre-1.0, launched in 2026Very mature (3.8 in October 2026)Mature (0.45.1 in October 2026)

Sources for the table: Flavio Copes’s three-way comparison and the October 2026 multiplexer roundup on Bitdoze, which verified the version numbers on October 29. Both are independent write-ups rather than project documentation, and I could not verify their testing, so I treated the table as reported comparison, not measurement.

Here is how I’d choose, based on those comparisons:

  • Stay on tmux if you manage servers you don’t own, where tmux is already installed, or you’ve built a configuration you rely on.
  • Pick Zellij if you want a friendlier multiplexer for your own hands, with key hints, layouts and floating panes, and you run agents as ordinary programs.
  • Pick Herdr if agents are most of what you run and the question “which one needs me?” costs you real time.

Two cautions apply to the agent-aware option. Herdr can fail to detect an agent when another multiplexer sits between Herdr and the agent, so running Herdr inside tmux, or tmux inside Herdr, undermines the main feature unless you configure hooks. And if your day is mostly shells and an editor, the agent features give you little.

Other tools solve adjacent problems. Munder Difflin’s comparison covers cmux (a macOS terminal with agent notifications), Claude Squad (a tmux-based interface with one Git worktree per agent) and several desktop apps, if you’d rather leave the terminal altogether.

Herdr is free and Apache-2.0 licensed now, though older reviews still say AGPL

The price is zero. There is no account, I found no public paid tier, and Herdr’s maker has announced Herdr Cloud as a future service without pricing. The agents you run inside it are a separate bill. Herdr doesn’t change what Claude Code or Codex cost you, and running five at once can multiply that spend.

The license is where reading the wrong article will mislead you. This is the history as reported by one reviewer who checked the repository’s LICENSE history on September 14, 2026:

DateLicense event
March 2026Launched under AGPL-3.0
May 26, 2026A commercial license option was added
July 22, 2026Relicensed to Apache-2.0

Herdr’s own announcement post footer now reads “Open source, Apache 2.0,” and the releases page sits under the herdrdev GitHub organization. Articles written before late July, such as an early Bitdoze review, describe the AGPL terms, so check the date on whatever you’re reading.

In practical terms, Apache-2.0 is a permissive license. You can use, modify and redistribute Herdr, including commercially, without publishing your changes, and the license includes an explicit patent grant. That matters to companies that ban AGPL software outright. I’m not a lawyer, and a company with strict compliance rules should read the actual LICENSE file in the repository instead of relying on a summary, including mine.

One caution applies to any project backed by a single maker. A relicense shows the copyright holder can change terms for future releases. Code already published under Apache-2.0 stays under it and can be forked, but you don’t get a guarantee about what comes next.

Where Herdr falls short: pace of change, heuristics and trust boundaries

The praise in the walkthrough video and the reviews is consistent. The caveats are just as consistent, and most of them come down to Herdr being young.

  • It changes quickly. The Gradually changelog collection lists eight releases between August 3 and October 14, 2026, ending at v0.9.5. Some include breaking changes: 0.9.0 removed the single-process mode and 0.9.2 removed a pane graphics API. Protocol changes can also require restarting the server before a newer client will attach. That page says its collection may be incomplete.
  • Status detection is inference. Unless an agent reports its own state through a hook, Herdr reads the screen. An unrecognized prompt can show as idle. If you depend on the blocked state, install the official integration for your agent and watch for it to misfire.
  • Layouts are basic. No floating panes, no tiling-style layouts.
  • Plugins run with your permissions. One roundup says the marketplace indexes around 1,000 plugins that run unsandboxed as your OS user, and advises reading a plugin’s source before installing it.
  • There is no sandbox for agents. Herdr organizes agents and does not contain them. It also doesn’t change what your agents send to their model providers.
  • Windows has edges. It is supported, but the multi-machine docs carry Windows-specific limits, including no support for native Windows servers as SSH targets in the preview docs I read.
  • Rendering reports. In an older review, some Hacker News commenters reported text rendering delays with ten or more panes. I couldn’t confirm whether that still applies.
  • Provenance. A copy of the project README that I could read in a fork says the author had never written Rust before starting, and built Herdr almost entirely with AI coding agents under the author’s supervision. That isn’t disqualifying, and the tool’s adoption suggests it works for many people, but it’s worth knowing when you decide how much to rely on a 0.x release. Check the current README for the exact wording.

The walkthrough’s enthusiasm is also one person’s experience. The presenter says they have used Herdr daily for about three months. That is useful testimony about workflow, but it isn’t a benchmark, and the video doesn’t test failure cases such as a misdetected prompt or a dropped SSH connection mid-task.

Questions readers ask about Herdr

Is Herdr open source?

Yes, under Apache-2.0 as of July 22, 2026, which is an OSI-approved license. It launched under AGPL-3.0, so articles from before late July may describe different terms.

Does it work with Claude Code and Codex?

Both are named in the v0.9.0 release notes and in the TecMint and Bitdoze reviews. Cursor, GitHub Copilot CLI, OpenCode, Pi, Devin, Amp, Gemini CLI, Hermes and others also appear, with detail varying by source. For an agent outside the list, Herdr still works as a plain multiplexer, and custom integrations can report agent labels over the socket API.

Can I use it without any AI agents?

Yes. Without agents you get workspaces, tabs, panes, mouse support and detach-and-reattach, which makes it a general multiplexer. The agent features simply have nothing to track. If that’s your situation, Zellij or tmux is the more proven choice.

Can I check on agents from my phone?

Not through Herdr itself. Third-party apps fill that gap. The October Bitdoze roundup names Moshi (with lock-screen approve and deny buttons) and Heeler as mobile options, and lists several web and desktop clients. They are separate projects with their own licenses and trust questions, so evaluate them separately.

Can I run Herdr inside tmux?

You can, but expect trouble. Herdr’s automatic detection can miss an agent that sits behind another multiplexer, and prefix keys, mouse handling and resizing get confusing when two layers compete. Pick one as the outer layer, and if you must nest, configure the agent hooks.

How this article was researched, and what I did not test

This is a research-based guide, not a hands-on review. I did not install or run Herdr for this article, and nothing here is first-hand testing. When I’ve genuinely tested a product, I say so in the review. This isn’t one of those.

Here is where the evidence came from:

  • Walkthrough video. A transcript of a third-party video demonstrating Herdr was supplied to me. Everything described as “in the walkthrough” comes from it and reflects the presenter’s experience. The transcript doesn’t name the presenter, and I didn’t use its unrelated sponsor segment.
  • Project sources. Herdr’s documentation on connecting machines, its announcement post from September 7, 2026, and the GitHub release notes for v0.9.0.
  • Independent write-ups. Reviews and comparisons from Bitdoze, TecMint, Flavio Copes, Munder Difflin and mer.vin, plus a changelog collection from Gradually.

Where sources disagreed, I reported the disagreement instead of picking a winner quietly. The conflicts I found: license terms (AGPL in older articles, Apache-2.0 now), Windows support (beta in early reviews, generally available later), the number of supported agents (12 to 15 or more depending on the source) and the install location of the script. I resolved the license question with the project’s own post and a dated history of its LICENSE file.

A few limits on my research. I couldn’t load Herdr’s homepage or its main GitHub README directly, so I relied on the documentation pages and release notes I could open. The performance and rendering comments come from older third-party reports and are marked as such. I haven’t verified the star counts or plugin counts in the Bitdoze roundup, so I left star counts out and used the plugin figure only with attribution. The video’s spelling “Herder” is a transcription error; the project is Herdr.

This article contains no affiliate links. If something here is out of date or wrong, tell me and I’ll correct it with a note on what changed. Herdr is on a fast release cycle, so check the version you install against the claims above.

Sources

Checked November 8, 2026. Pages I opened and read:

  1. Connecting machines, Herdr documentation
  2. Connecting the machines, Herdr announcement post, September 7, 2026
  3. Herdr v0.9.0 release notes, GitHub, September 7, 2026
  4. Herdr changelog collection, Gradually, newest entry v0.9.5 (October 14, 2026)
  5. Herdr Review: Open-Source Agent Multiplexer for AI Coding, Bitdoze, July 10, 2026, updated September 2, 2026
  6. Best Terminal Multiplexers in 2026, Bitdoze, October 29, 2026
  7. herdr: A Terminal Tool for Managing Multiple AI Coding Agents, TecMint
  8. Herdr vs tmux vs Zellij, Flavio Copes, August 23, 2026
  9. Herdr Alternatives: What to Pick and Who Each One Fits, Munder Difflin, September 14, 2026
  10. Herdr Explained, mer.vin, July 2026

Read only as a search excerpt, not opened in full: the project README as copied in a GitHub fork, used for the note on how Herdr was built.

About the author: Alex Carter is the founder of BoostStash and BriefFlash. His background is in digital solutions, programming, SaaS and automation, and BoostStash is where he evaluates AI tools and software from the perspective of someone trying to get real work done.

1 comment

Comments are closed.