OpenSource-Hub
H

herdr

SHA-256
33.3k stars·Developer Tools·SHA-256 checksum verified

herdr is a persistent background runtime for coding agents. It keeps terminals alive across reboots and network drops, lets agents work autonomously, and gives every pane a visual status (working, blocked, idle). Unlike tmux or screen, it is agent-native with a socket API and a single Rust binary—no Electron overhead.

Smart Download

Download Download Version

v0.8.2 · 19.8 MB

A persistent terminal runtime for coding agents—sessions survive reboots, panes show status, and agents collaborate natively.

Core Features

  • Runs as a background server; sessions survive laptop lid close, network drops, and machine restarts
  • Every pane is marked working, blocked, or idle—no more hunting for stuck agents
  • Agent-native: agents can spawn panes, prompt each other, and wait for blocked states via CLI and socket API
  • Works with Claude Code, Codex, Cursor, OpenCode, Grok, and other existing agents
  • Hybrid input: tmux-style prefix keys plus click, drag, and split support

What It Can't Do

  • •Do not expect it to replace tmux entirely if you rely on advanced traditional terminal multiplexer features. Remote persistence may require extra setup (see official remote docs). Windows support is currently in beta and may have missing functionality. If you use the socket API, review the official security guidance before exposing it.

Use Cases

  • Run multiple coding agents in the background while you step away; reattach from any terminal later
  • Manage agents on a remote server via SSH and retain the entire work session after disconnection

Detailed Introduction

herdr is a lightweight background server that acts as the runtime for AI coding agents and terminal-based workflows. It runs in whatever terminal you already use, providing a persistent environment where agents like Claude Code, Codex, Cursor, and OpenCode operate without interruption. The key differentiator is its agent-native design: agents can spawn panes, prompt each other, and wait for genuinely blocked states via a CLI and socket API. Every pane is marked working, blocked, or idle, so you never hunt for the stuck process. Sessions survive closed lids, dropped networks, and machine restarts; you can reattach from any terminal or over SSH. Compared to plain tmux, herdr offers a first-class mouse/keyboard hybrid experience and a plugin system. It ships as a single Rust binary with no Electron dependency.

Tags

terminalcoding-agentsaitmux-alternativebackground-serverrustpersistent-session

Getting Started

1

Download installer

Click the button above to download the installer for your system

Linux· 19.8 MBWindows· 21.7 MBmacOS· 18.1 MB
2

Install the software

Install the appropriate package for your distro (dpkg / rpm / AppImage)

3

Run: curl -fsSL https://herdr.dev/install.sh | sh (or brew install herdr)

4

Start herdr in your project directory, then launch your coding agent

5

Detach with Ctrl+B then Q; reattach anytime with the `herdr` command

Install Guide
  1. Run: curl -fsSL https://herdr.dev/install.sh | sh (or brew install herdr)
  2. Start herdr in your project directory, then launch your coding agent
  3. Detach with Ctrl+B then Q; reattach anytime with the `herdr` command
File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

976150a14d490c94b243ea2e1a7eb2dfb67f12e36b182db90936f6728e6aecf4

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

For Homebrew installs, run `brew uninstall herdr`. For script installs, remove the herdr binary (typically ~/.local/bin/herdr) and its config directories (like ~/.herdr or ~/.config/herdr). No background processes remain after removal.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseApache-2.0
Last Updated2026-08-29T12:14:56Z
GitHub RepositoryOfficial Website

Similar Projects

O

opencode

OpenCode is a free, open-source AI coding agent that helps you write, refactor, and understand code. It offers two built-in modes: a full-access 'build' agent for active coding and a read-only 'plan' agent for safe exploration.

C

codex

OpenAI's lightweight coding agent that runs locally in your terminal, with no IDE dependency and seamless ChatGPT integration.

L

lazygit

A simple terminal UI for git commands