About this project
Herdr positions itself as "the runtime your coding agents live on." It is a background terminal server that preserves sessions when clients disconnect, SSH connections drop, or machines restart. On recovery, Herdr restores the saved pane layout and can resume supported agent sessions, though original processes do not survive restarts.
The tool supports multiple machines—local work and saved SSH hosts are managed in a single window with a combined agent list and independent reconnects. Each pane is visually marked as working, blocked, or idle, so users are notified when an agent stops and needs input.
Herdr is designed to be agent-native: AI agents control it through the CLI and a socket API. Agents can spawn panes, prompt one another, and wait until another agent is genuinely blocked, without Herdr wrapping or replacing the agents themselves. It runs whatever terminal-based agents you already use, including Claude Code, Codex, Cursor, OpenCode, Grok, and others.
Interaction is keyboard- and mouse-first, offering tmux-style prefix keys alongside click, drag, and split gestures. Plugins can extend panes and workflows, and a marketplace is available. The entire application is a single Rust binary with no Electron dependency, designed to run inside the terminal you already use.
Installation is via a shell script (curl -fsSL https://herdr.dev/install.sh | sh), Homebrew (brew install herdr), mise (mise use -g herdr), or a PowerShell script on Windows. After installation, starting `herdr` in the directory where work lives opens the session; `ctrl+b q` detaches, and re-running `herdr` reattaches.
Comprehensive documentation, including quick start, concepts, supported agents, keyboard shortcuts, configuration, session state, remote machine connection, persistence, integrations, plugins, and socket API, is hosted at herdr.dev/docs. The project is licensed under Apache 2.0 and relies on community sponsors and backers.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.