gitwtfhub

wtf is herdr?

ogulcancelik/herdr — explained in plain English

Analysis updated 2026-05-18

19,424RustAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A terminal app that lets you run, monitor, and detach from multiple AI coding agents at once, with agents able to coordinate through a socket API.

Mindmap

mindmap
  root((herdr))
    What it does
      Shows all agents at a glance
      Sessions survive detach
      Agents coordinate via socket API
    Tech stack
      Rust
      Single binary
      Socket API
    Use cases
      Run multiple AI agents in parallel
      Reattach to sessions over SSH
      Let agents spawn and monitor panes
    Audience
      Developers using AI coding agents
    Setup
      One-line install script
      Also on Homebrew
      Windows beta available

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Watch multiple AI coding agents at once from one terminal window.

REASON 2

Detach from a session and reattach later, even over SSH, without losing state.

REASON 3

Let agents spawn new panes and coordinate with each other through the socket API.

REASON 4

Split terminal panes with either keyboard shortcuts or mouse clicks.

What's in the stack?

Rusttmux-style keysSocket API

How it stacks up

ogulcancelik/herdrhigherorderco/bend0x192/universal-android-debloater
Stars19,42419,35219,293
LanguageRustRustRust
Setup difficultyeasyhardmoderate
Complexity2/54/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Single install script or package manager command, no other dependencies mentioned.

Wtf does this do

Herdr is a terminal application for people who run multiple AI coding agents at once, like several instances of Claude Code working on different tasks. It shows all of your agents in one place and tells you at a glance which ones are blocked waiting for input, which are still working, and which have finished. Instead of showing a simplified summary, it displays the real terminal output of each agent, so you see exactly what each one is doing. One of its main features is that agent sessions keep running even after you detach from the terminal. You can close your laptop or disconnect over ssh, come back later, and reattach to find your agents still working, with their state intact. It supports both keyboard shortcuts similar to the tool tmux and normal mouse actions like clicking and dragging, so people can use whichever fits the moment. Herdr also exposes a socket based API that the agents themselves can use, letting one agent spawn new terminal panes, read output from other panes, or wait for another agent to finish before continuing. This means agents can coordinate with each other through Herdr rather than only being watched by a human. The tool also supports plugins that extend how panes and workflows behave. It is written in Rust and ships as a single binary with no Electron or other heavy runtime, so it runs in whatever terminal you already use on Mac, Linux, or a Windows beta. Installation is a single command line script, or available through Homebrew and other package managers. The project is dual licensed: free under the AGPL license, with a separate commercial license available for organizations that cannot use AGPL terms.

Yoink these prompts

Prompt 1
Walk me through installing herdr and starting my first agent session.
Prompt 2
Explain how the socket API lets agents spawn and monitor each other's panes.
Prompt 3
Show me how session detach and reattach works, including over SSH.
Prompt 4
Help me understand the difference between the AGPL and commercial license options.

Frequently asked questions

wtf is herdr?

A terminal app that lets you run, monitor, and detach from multiple AI coding agents at once, with agents able to coordinate through a socket API.

What language is herdr written in?

Mainly Rust. The stack also includes Rust, tmux-style keys, Socket API.

How hard is herdr to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is herdr for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.