Skip to content
frdmincPublic
forked from herdrdev/herdr

About

the runtime your coding agents live on

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

1,761 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

herdr

herdr

herdr.dev · install · quick start · docs

English · 简体中文

Apache 2.0 license total GitHub release downloads GitHub stars latest stable release Homebrew version follow @herdrdev on X


v.0.4.0.mp4

the runtime your coding agents live on.

  • detach without stopping work — herdr keeps terminals running in a background server when you close the client or lose your SSH connection. after a server or machine restart, herdr restores the saved layout and can resume supported agent sessions; the original processes do not survive. session state →
  • several machines, one window — keep local work and saved ssh machines together, with a combined agent list and independent reconnects. remote machines →
  • 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.

install

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

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

then start it where the work lives:

herdr

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

docs

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

thanks

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

enterprise / partnership: hey@herdr.dev

djbclark fork notes

This repository is a fork of herdrdev/herdr. Day-to-day installs should still follow upstream docs and releases. Branches and discussions below are local experiments and community posts, not upstream merge requests from a maintainer account.

Local branches of interest

  1. command-surface — fork-only command-surface experiments.
  2. herdr-sleeper — standalone sleeper script path later reborn as the herdr-sleeper plugin.

Upstream discussion posts

  1. Discussion 5861 — plain-English command line (herdr-plain-line plugin).
  2. Discussion 2283 comment — related naming / surface notes.
  3. Discussion 631 — agent sleep / hibernate (herdr-sleeper).
  4. Discussion 1674 — native destination-picker ideas.

Related djbclark Herdr repos

Repo Role
frdminc/herdr Fork of herdrdev/herdr
herdr-plain-line Local plugin: plain-English popup for tab/workspace rename and create
herdr-sleeper Plugin: sleep idle agent panes, wake later
herdr4paseo Terminal UI to watch/steer a Paseo agent from a pane
paseo4herdr Paseo plugin mirroring OMP agents that run in Herdr

agent instructions

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.

development

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

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

license

Herdr is licensed under the Apache License 2.0.

About

the runtime your coding agents live on

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages