Herdr

A mouse-native, agent-aware terminal multiplexer written in Rust. Herdr behaves like a tmux-style multiplexer (persistent panes, detach/reattach, a Ctrl + B prefix) but treats coding agents — Claude Code, Codex, and others — as first-class objects: panes can be scanned for agent state (idle, working, blocked) and jumped to directly.

Note: This repository vendors dotfiles/.config/herdr/config.toml (deployed to ~/.config/herdr/config.toml): the catppuccin theme with catppuccin-latte for light mode and first-run onboarding disabled. The keybindings below are Herdr's upstream defaults — the vendored config does not rebind them.

Installation

• Nix: nix run github:herdrdev/herdr (not yet in nixpkgs proper)
• Homebrew: brew install herdr
• Mise: mise use -g herdr
• GitHub releases: download a binary
• Cargo: build from source with cargo build --release

Configuration

• Config: dotfiles/.config/herdr/config.toml (TOML, deployed to ~/.config/herdr/config.toml)

Configuration topics covered upstream include keybindings, themes, sidebar/dashboard layout, notifications, and scrollback buffer size (10 MB default). See Herdr documentation for the full reference.

Keybindings

Prefix: Ctrl + B (press and release, then press the action key).

Action	Shortcut
New workspace	Ctrl + B, then Shift + N
Split pane (vertical)	Ctrl + B, then V
Split pane (horizontal)	Ctrl + B, then -
New tab	Ctrl + B, then C
Switch workspaces	Ctrl + B, then W
Detach	Ctrl + B, then Q
Help / all bindings	Ctrl + B, then ?

Herdr is also mouse-native: click panes, drag borders to resize, and split or switch from right-click menus without touching the keyboard.

Agent detection

Panes running a supported agent (Claude Code, Codex, Devin CLI, GitHub Copilot CLI, and others) are detected automatically by process name and terminal output, and surfaced in the sidebar with their state (idle/done, working, blocked). herdr integration install <agent> wires up native session restore for supported agents.