Repolode
Submit
herdrdev

herdrdev/herdr

A Rust terminal workspace that runs coding agents in persistent panes, tracks which ones are working, blocked, or idle, and lets agents control it via CLI and socket API.

Open-source alternative to:tmux

View on GitHubWebsite
Stars
44,785
Forks
3,566
Open issues
388
Last commit
23 hours ago

What is it?

herdr is a terminal workspace for running coding agents such as Claude Code, Codex, Cursor, OpenCode and Grok. It works like a terminal multiplexer: panes are split and arranged inside a window, and the terminals are kept running in a background server, so closing the client or losing an SSH connection does not stop the work. After a server or machine restart, herdr restores the saved layout and can resume supported agent sessions, though the original processes are not kept alive.

Each pane is marked as working, blocked, or idle, so it is easy to see which agent has stopped and needs an answer. Local work and saved SSH machines can be shown together in one window with a combined agent list. Agents can also drive herdr themselves through the CLI and socket API, for example to spawn panes, send prompts to other agents, or wait until another agent is blocked. Keyboard prefix keys and mouse actions such as click, drag, and split are both supported.

herdr is a single Rust binary that runs inside an existing terminal emulator, and it is installable via a shell script, Homebrew, mise, or PowerShell on Windows. It is licensed under Apache-2.0 and offers a plugin system.

Key features

  • 01Keeps terminals running in a background server across client detaches and SSH drops.
  • 02Restores saved layouts and can resume supported agent sessions after restarts.
  • 03Marks every pane as working, blocked, or idle.
  • 04Lets agents spawn panes and prompt each other through the CLI and socket API.
  • 05Combines local and remote SSH machines in one window with a unified agent list.
  • 06Supports both tmux-style prefix keys and mouse interaction.

Use cases

  • Running several coding agents in parallel and checking which one needs input.
  • Keeping long agent sessions alive over an unstable SSH connection.
  • Coordinating agents on multiple remote machines from one terminal window.

Quick start

  1. 1

    Install herdr with the install script

    curl -fsSL https://herdr.dev/install.sh | sh
  2. 2

    Start herdr in your working directory

    herdr

Things to know

  • Windows support is in beta and requires an endpoint-protected setup.

Topics

#terminal-multiplexer#coding-agents#tui#cli#tmux#developer-tools#agent-orchestration#agent#ai#ai-agents

FAQ

What is herdr?
A Rust terminal workspace that runs coding agents in persistent panes, tracks which ones are working, blocked, or idle, and lets agents control it via CLI and socket API. herdr is a terminal workspace for running coding agents such as Claude Code, Codex, Cursor, OpenCode and Grok. It works like a terminal multiplexer: panes are split and arranged inside a window, and the terminals are kept running in a background server, so closing the client or losing an SSH connection does not stop the work. After a server or machine restart, herdr restores the saved layout and can resume supported agent sessions, though the original processes are not kept alive.
Is herdr free to use? What license does it have?
herdr is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is herdr still maintained?
Actively maintained. The last commit to herdr was on Oct 18, 2026.
What can I use herdr for?
Running several coding agents in parallel and checking which one needs input. Keeping long agent sessions alive over an unstable SSH connection. Coordinating agents on multiple remote machines from one terminal window.
How do I install herdr?
Install herdr with the install script: curl -fsSL https://herdr.dev/install.sh | sh Start herdr in your working directory: herdr
Where can I get herdr?
The source code and installation instructions are on GitHub: https://github.com/herdrdev/herdr

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects