> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getdax.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Herdr

> Run a herd of coding agents in one window — locally or on a server over SSH.

**Herdr** is mission control for coding agents. Connect a folder and it opens
a window of live terminals running side by side. Add agents from a menu,
split by dragging, and watch them all work — on your Mac or on a server you
connect over SSH.

Powered by [Herdr](https://herdr.dev), a terminal multiplexer with built-in
agent detection. Dax handles the window, the sidebar, and the installs; Herdr
handles the terminals.

## Open it

Press <kbd>⌃</kbd> <kbd>⌥</kbd> <kbd>.</kbd> from any app.

## How it works

<Steps>
  <Step title="Connect a folder">
    Press <kbd>⌃</kbd> <kbd>⌥</kbd> <kbd>.</kbd> or go to **Settings → Herdr**
    and connect the project folder you're working in.
  </Step>

  <Step title="Add agents">
    Click the **+** or use the agent menu to add Claude Code, Codex, Gemini,
    or any other agent. Each one opens in its own terminal pane.
  </Step>

  <Step title="Split and arrange">
    Drag a pane against the edge of another to split the space between them.
    **Even Out Terminals** squares up the seams without restarting anything.
  </Step>
</Steps>

## Tabs

Organize your herd with tabs:

* <kbd>⌘</kbd><kbd>T</kbd> to open a new tab
* <kbd>⌘</kbd><kbd>N</kbd> to add an agent
* <kbd>⌃</kbd><kbd>Tab</kbd> to walk the tab bar
* <kbd>⌘</kbd><kbd>W</kbd> to close an agent (not the whole window)
* Name a tab while you still remember what it was for

The sidebar groups agents under their tab, one line each.

## The sidebar

A tree that tells you what's running:

* **Tabs** hold agents, each showing brand and status at a glance
* Rename anything, close anything, collapse the sidebar out of the way
* A collapsed sidebar still groups by tab instead of one flat list

## Running on a server

Connect a server and Herdr reaches it down a single SSH forward — same
window, same tabs, same agents, running on the machine that has the repo,
the RAM and the uptime.

<Steps>
  <Step title="Add a server">
    Go to **Settings → Herdr → Servers** and add a host: address, user, port,
    and a key file or password. Passwords are stored in your Keychain.
  </Step>

  <Step title="Switch to the server">
    Pick the server from the switcher above the sidebar tree. Its projects
    and live terminals appear exactly as local ones do.
  </Step>

  <Step title="Test the connection">
    Press **Test** (right next to Done) to see the connection happen: which
    address answered, which key was offered, what the server accepted. Copy
    the whole log if you need to debug.
  </Step>

  <Step title="Install herdr automatically">
    If the server doesn't have herdr yet, Dax installs it automatically. On
    IPv6-only servers where GitHub is unreachable, Dax sends the binary over
    the SSH connection already open.
  </Step>
</Steps>

<Note>
  Your `~/.ssh/config`, agent, and `known_hosts` still apply. No new dependency
  is added — everything goes through the SSH connection. Addresses pasted from
  a cloud console are cleaned of invisible characters, and downloaded key files
  have their permissions narrowed automatically.
</Note>

### Remote Panel

A button in the Herdr toolbar (shown only for servers) opens the Remote Panel
with five tabs:

* **Coding Agents** — what's installed, with a one-click update
* **Services & Ports** — listening processes and open ports
* **Web Servers & SSL** — sites grouped by domain, with certificates and expiry
* **Usage** — disk, memory, load, and a live console
* **Utilities** — common server tools

## Splitting

Drag a pane toward the edge of another (left, right, top, bottom) and the
space divides between them. Green fills the target area to show where the
split will land. The divider is draggable afterward.

**Even Out Terminals** (from the menu) redistributes the space evenly without
restarting any process.

## Agent detection

Herdr detects 19+ coding agents out of the box: Claude Code, Codex, Gemini,
Cursor, Grok, Pi, OpenCode, and more. When an agent is running in a pane,
the sidebar shows its brand icon and reports whether it's working, blocked,
or idle.

## Going full screen

Green fills the screen rather than taking it over. The menu bar and the Dock
stay where they are, so a wall of terminals doesn't cost you the rest of your
Mac.

## Installing Herdr

The first time you open the tool, Dax offers to install
[Herdr](https://herdr.dev) via Homebrew or a one-line script. Once installed,
it runs as a background server, so sessions persist even when you close the
window.

## Privacy

Everything runs locally or through a direct SSH connection to your own
server. Your terminals, your agents, your code: nothing goes through the Dax
backend.