What is herdr?
If the app sent you here, it found outridr running on your machine but no herdr behind it. herdr is the program that actually runs your agents; outridr is the window your phone looks through. Without herdr there is nothing to show.
herdr is a terminal multiplexer built for coding agents. It runs Claude Code, Codex, OpenCode, and other terminal agents in persistent sessions on any machine, including one you only ever reach over SSH, and keeps them alive when you close the terminal. It's a single binary with no Electron app, no account, and no telemetry.
herdr also exposes a socket API that reports what each agent is doing: working, blocked, waiting for you. That API is what outridr reads, and what the app renders as statuses and transcripts.
Get it running
On the machine where you installed outridr (Linux or macOS):
curl -fsSL https://herdr.dev/install.sh | sh Then start it:
herdr
Inside, launch an agent the way you always do: run claude (or
codex, opencode, whatever you ride with) in a pane, and herdr
detects it automatically. Homebrew and Nix installs, keybindings, and everything else are
in herdr's own docs.
outridr needs herdr 0.7.0 or newer. Once a session is up, reopen the outridr app and the herd should be there.