herdr

herdr.dev · install · quick start · docs

English · 简体中文

This is ajessu/herdr, a personal fork of herdrdev/herdr kept in sync with upstream releases (see UPSTREAM.md for the sync process). On top of everything upstream ships, this fork adds:

• zellij-faithful tab bar — stateless centered-active layout, Powerline/alternating- background painting, proportional compression, wheel-to-pan browse mode when tabs overflow, a context menu (move left/right, close), middle-click close, double-click rename, and per-tab agent status dots (ui.show_tab_status).
• contextual hint bar — a zellij-style bar along the bottom showing the active mode's available shortcuts, with an Alt-shortcut section.
• redesigned sidebar — a 7-column button-like minimized rail with attention gating, attention-aware overflow badges (three disaggregated working/blocked/done-unseen counts) across tabs/rail/panels, and a responsive width (ui.sidebar_width_ratio) instead of a fixed column count.
• mode-structured keybind config — replaces the flat [keys] schema with a zellij-compatible modal one (mode_pane/mode_tab/mode_resize/mode_move/ mode_session/mode_locked/mode_tmux, independent per-mode keyspaces, mode-entry and shared-binding precedence), plus direct alt+key shortcuts alongside the prefix model and a break_pane_to_tab keybinding.
• stacked panes — group panes into a stack within a split (Node::Stack), with keybinds, resize, and persistence support.
• Claude Code statusLine integration — herdr integration install claude takes over Claude Code's statusLine to report the active model into herdr's sidebar, chaining your existing statusline command so nothing else changes. Settings.json edits are atomic, concurrent-write-guarded, and formatting-preserving.
• agent CLI additions — tab_label/workspace_label on herdr agent list/get so callers don't need to join against tab.list/workspace.list, and a --status filter for herdr agent list.
• nested-launch and remote hygiene — experimental.allow_nested defaults to true with a same-server recursion guard (rather than blocking all nesting), and remote/tunnel subprocesses have every HERDR_* runtime env var scrubbed, not just the socket path.

the runtime your coding agents live on.

• always running — herdr is a background server; the terminals live inside it. close the lid, drop the network, or restart the machine; agents keep working and sessions come back. reattach from any terminal, or over ssh.
• never hunt for the stuck one — every pane is marked working, blocked, or idle. when an agent stops and needs an answer, herdr says so.
• agent-native — agents drive herdr through the cli and socket api: they can spawn panes, prompt each other, and wait until another agent is genuinely blocked. agent skill →
• runs what you already run — claude code, codex, cursor, opencode, grok and the rest. herdr doesn't wrap or replace them; it owns their terminals.
• keyboard and mouse, both first-class — tmux-style prefix keys and click, drag, split. pick per moment, not per tool.
• plugins — extend panes and workflows. browse the marketplace →
• one rust binary, no electron — runs in whatever terminal you already use.

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

or brew install herdr · mise use -g herdr · windows beta: powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex" · binaries

then start it where the work lives:

herdr

run your agents, split panes, walk away. ctrl+b q detaches, herdr reattaches. quick start →

everything lives at herdr.dev/docs: quick start · concepts · supported agents · keyboard · configuration · session state · remote · integrations · plugins · socket api

every past sponsor and backer is listed in SPONSORS.md — thank you 🐑

enterprise / partnership: hey@herdr.dev

if you are an ai agent helping with this repository, read AGENTS.md before making changes and read CONTRIBUTING.md before opening issues or PRs.

git clone https://github.com/herdrdev/herdr
cd herdr
cargo build --release

just test        # unit tests
just check       # formatting, tests, and maintenance checks

Herdr is licensed under the Apache License 2.0.