🧭 Decision Guide
Why trending now: Cannot be determined from the provided material
Try it if you
-
You often close the client or lose SSH while needing to retain Claude Code or Codex layoutsThe README section “detach without stopping work” says the background server keeps terminals and restores the saved layout
-
You run coding agents locally and on multiple SSH machinesThe README section “several machines, one window” describes a combined agent list with independent reconnects for local and saved SSH machines
-
You want agents to create panes and wait for other agents through the CLI or Socket APIThe README section “agent-native” explicitly lists spawning panes, prompting each other, and waiting for blocked agents
Skip it if you
-
You require the original agent processes themselves to survive a server or machine restartThe README explicitly states, “the original processes do not survive”
-
Your Windows environment is endpoint-protected and you cannot use a Windows Beta pathThe install section links endpoint-protected Windows separately to the windows-beta documentation
-
You only need simple single-machine, single-terminal agent startup without layout recovery or a multi-machine listThe README’s core features center on background sessions, saved layouts, SSH machines, and agent-state management
Requirements
- A usable terminal is required; the README says herdr “runs in whatever terminal you already use.”
- Install herdr using a README-listed path such as the curl installer, Homebrew, mise, or the Windows PowerShell command.
- For remote use, the saved SSH-machine and independent-reconnect workflow described by the README is required.
- Source development requires a Rust build toolchain; the README development section uses cargo build --release.
First step (verbatim from README)
curl -fsSL https://herdr.dev/install.sh | sh
Watch out
-
Do not confuse layout restoration with process restoration; the README explicitly excludes original-process survivalThe README’s “session state” description mentions saved-layout and supported-session recovery while stating that original processes do not survive
-
Windows endpoint-protected users must consult windows-beta rather than relying only on the generic install commandThe install section links endpoint-protected Windows to https://herdr.dev/docs/windows-beta/
-
Agent integration is not an automatic wrapper; the README directs builders to the add herdr support documentationThe README says herdr does not “wrap or replace” existing agents and provides an add herdr support link
Alternatives
-
tmux:Prefer it when you only need classic terminal multiplexing and not herdr’s agent states, Socket API, or multi-machine agent listREADME’s “tmux-style prefix keys” and general domain knowledge
Not stated in the README
- The README does not specify supported versions of Claude Code, Codex, Cursor, OpenCode, or Grok.
- The README provides no CPU, memory, disk, or network-bandwidth requirements.
- The README does not identify which specific agents qualify as “supported agent sessions” after a server restart.
- The README does not state the stability scope, limitations, or formal release date of Windows Beta.
- The README does not explain SSH authentication methods, port configuration, or remote-machine limits.
- The README does not describe Socket API authentication, access control, or compatibility details.
- The README does not state the plugin marketplace’s plugin count, maintenance status, or security-review process.
- The README does not provide the changes in v0.9.5 compared with the previous release.
💡 Deep Analysis
6
It depends
I need saved pane layouts and some agent sessions restored after a machine reboot; can herdr guarantee that the original Claude Code or Codex processes keep executing?
It depends: herdr can restore the layout and some supported agent sessions, but it cannot guarantee that the original Claude Code or Codex processes survive a reboot.
- The README states that after a server or machine restart, herdr restores the saved layout and “can resume supported agent sessions.”
- The same statement explicitly says, “the original processes do not survive,” so this is not process-level checkpointing or guaranteed task continuity.
- Recovery depends on whether the agent is supported and whether the relevant session state was saved. The README lists Claude Code, Codex, Cursor, OpenCode, and Grok, but does not define recovery coverage for each one.
The project therefore fits a requirement to recover the workspace view, but not a requirement that the exact original process continue executing without interruption.
- README: detach without stopping work — “after a server or machine restart, herdr restores the saved layout and can resume supported agent sessions; the original processes do not survive”
- README: runs what you already run — “claude code, codex, cursor, opencode, grok and the rest”
- Project insight: usage limitations — “cross-restart recovery is not complete process-level recovery”
herdr
Yes
I already use Claude Code, Cursor, and OpenCode, and my team does not want to migrate to a new agent wrapper layer; will herdr replace or rewrite these agents?
Yes, because the README explicitly says that herdr does not wrap or replace existing agents; it owns the terminals in which they run.
- “runs what you already run” lists Claude Code, Cursor, OpenCode, Codex, and Grok, indicating that the intended workflow is to host existing tools.
- The README says, “herdr doesn’t wrap or replace them; it owns their terminals,” so migration means placing agents in herdr panes rather than rewriting their invocation model.
- It also provides tmux-style keyboard controls plus mouse clicking, dragging, and splitting, so an existing terminal workflow does not have to become entirely graphical.
However, generic terminal hosting does not guarantee full status detection, session recovery, or agent-native control for every agent. Those capabilities depend on the integration support available for the specific tool.
- README: runs what you already run — “herdr doesn't wrap or replace them; it owns their terminals”
- README: runs what you already run — “claude code, codex, cursor, opencode, grok and the rest”
- README: keyboard and mouse, both first-class — “tmux-style prefix keys and click, drag, split”
herdr
Yes
I am building a coding agent and want it to create panes, prompt other agents, and wait for blocked states through the CLI and Socket API; does herdr provide that control plane?
Yes, because agent-native control is an explicit design goal of herdr, and the README provides dedicated integration entry points.
- The “agent-native” section says agents can drive herdr through the CLI and Socket API rather than merely running inside its terminals.
- It explicitly lists spawning panes, prompting other agents, and waiting until another agent is genuinely blocked, which directly matches the requested orchestration behavior.
- The documentation index includes “agent skill,” “add herdr support,” and “socket api,” showing that agent integration is a first-class interface rather than keyboard automation alone.
- The plugin system can also extend panes and workflows.
The README does not provide the API schema, authentication model, error responses, compatibility policy, or safeguards against circular waits. Those omissions prevent a conclusion about production-grade orchestration readiness.
- README: 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”
- README: docs — “agent skill” · “add herdr support” · “socket api”
- README: plugins — “extend panes and workflows”
git clone https://github.com/herdrdev/herdr
Yes
I connect to cloud machines over SSH and run Claude Code and Codex at the same time; can I continue managing these agents after my local terminal closes or the SSH connection drops?
Yes, because herdr separates the lifetime of the terminal workspace from the lifetime of the client connection, specifically targeting SSH disconnects and parallel agent management.
- The README section “detach without stopping work” says terminals continue running in a background server after the client closes or the SSH connection is lost.
- “several machines, one window” places local work and saved SSH machines in one interface, with independent reconnects.
- The project explicitly supports Claude Code and Codex, and marks panes as working, blocked, or idle so you can find agents that need attention.
It does not remove failures caused by an unreachable host, invalid SSH credentials, or insufficient remote resources. The README does not specify reconnection behavior, supported SSH configurations, or resource limits when several agents run simultaneously.
- README: detach without stopping work — “herdr keeps terminals running in a background server when you close the client or lose your SSH connection”
- README: several machines, one window — “keep local work and saved ssh machines together, with a combined agent list and independent reconnects”
- README: runs what you already run — “claude code, codex, cursor, opencode, grok and the rest”
curl -fsSL https://herdr.dev/install.sh | sh
Yes
I am comfortable with tmux keyboard controls but need to monitor working, blocked, and idle states across several agents; will herdr force me into a mouse-only or full desktop interface?
Yes, because herdr preserves tmux-style keyboard interaction while adding mouse controls and visible agent states inside panes.
- The README section “keyboard and mouse, both first-class” explicitly supports tmux-style prefix keys as well as clicking, dragging, and splitting, so the keyboard workflow is not removed.
- “never hunt for the stuck one” says every pane is marked working, blocked, or idle, and alerts the user when an agent stops and needs an answer.
- The project is a terminal runtime and workspace manager rather than an Electron desktop application; the README emphasizes “one rust binary, no electron.”
However, a state label does not guarantee accurate detection for every agent. The project insight notes that output formats and interaction modes can affect blocked-state detection, while the README does not document per-agent detection rules or false-positive handling.
- README: keyboard and mouse, both first-class — “tmux-style prefix keys and click, drag, split”
- README: never hunt for the stuck one — “every pane is marked working, blocked, or idle”
- README: one rust binary, no electron
- Project insight: common pitfalls — “different agents may vary in output format, interaction mode, and blocked-state detection”
herdr
It depends
I need to deploy the same terminal tool on Linux, macOS, and an endpoint-protected Windows environment; is herdr's single-binary approach sufficient?
It depends: the delivery model is well aligned with consistent deployment across platforms, but endpoint-protected Windows requires separate validation.
- The README describes herdr as “one rust binary, no electron” and says it runs in the terminal you already use, reducing Electron runtime dependencies.
- The installation section provides shell installation, Homebrew, mise, a Windows PowerShell command, and binary downloads.
- It also links to a separate “endpoint-protected Windows” path; the project insight indicates that this Windows Beta route may have enterprise compatibility or deployment restrictions.
- Project data identifies Rust as the main language, with the overwhelming majority of the code in Rust, suggesting a relatively uniform delivery architecture.
It is therefore a good fit for ordinary cross-platform installation, but the README does not establish that it can be deployed directly where remote scripts, execution policies, or unverified binaries are restricted.
- README: one rust binary, no electron — “runs in whatever terminal you already use”
- README: install — “brew install herdr · mise use -g herdr · windows: powershell ... · endpoint-protected Windows · binaries”
- Project data: main_language is Rust; language_distribution reports 11926094 Rust code units
- Project insight: usage limitations — the “Windows Beta path” may have enterprise compatibility or deployment restrictions
brew install herdr
✨ Highlights
-
A single Rust binary with no Electron, running in your existing terminal
-
Keeps terminals after SSH loss and restores the saved layout on reconnect
-
Manages Claude Code and Codex across local and SSH machines
-
The CLI and Socket API let agents spawn panes and prompt one another
🔧 Engineering
-
Press Ctrl+B Q to detach, then run herdr to reattach the session
-
Each pane is marked working, blocked, or idle to show when an agent needs an answer
-
Supports the original terminals of Claude Code, Codex, Cursor, OpenCode, and Grok
-
Plugins extend panes and workflows, while both keyboard and mouse controls are supported
⚠️ Risks
-
After a restart, only supported agent sessions resume; the original processes do not survive
-
Endpoint-protected Windows is documented separately as Windows Beta
-
The README lists Claude Code and other agents but specifies no supported versions
👥 For who?
-
Terminal developers who run Claude Code or Codex for extended periods
-
Teams managing multiple machines over SSH that want one combined agent view
-
Developers building agents that need CLI or Socket API integration