Skip to content
moshpit

Docs · Topic

herdr

herdr is a terminal multiplexer built around coding agents, organizing terminals into Workspaces, Tabs, and full-width panes. When Multiplexer is set to herdr on a connection, Moshpit talks directly to herdr’s socket and frame channel over SSH or Mosh.

Moshpit connects to your running herdr server without spawning daemons unasked:

  • If herdr has active workspaces, tapping the host opens your workspace and streams the focused pane at your phone’s width.
  • If no workspace exists yet (No herdr workspaces on this host), tap New Workspace to start herdr server and open a fresh workspace—or tap New Agent Task on Home to create a git worktree workspace and launch an agent inside it; see Git worktrees.
  • If herdr is not installed on the host, Moshpit says so and opens a plain shell.

Built-in agent state and Lock Screen pushes

Section titled “Built-in agent state and Lock Screen pushes”

herdr tracks coding agent state natively. Without installing anything extra on the host, Moshpit reads each pane’s status straight from herdr and shows Needs you, Working, and Idle on Home, in the breadcrumb, and on the Dynamic Island.

To also receive end-to-end encrypted Lock Screen pushes when Moshpit is closed, run Set up a host once to pair the host and install the push script.

Use the top breadcrumb or the pane overview to move around:

  1. Tap the workspace segment for Workspaces, or tap the tab/pane segments for the overview.
  2. Tap + to create a New Workspace, open a New tab, or add a pane.
  3. Long-press a tab or pane (or tap ⋯ on a card) for Rename tab…, Close tab…, or Close pane….

Moshpit searches your login PATH plus /opt/homebrew/bin, /usr/local/bin, and ~/.local/bin. To use a binary elsewhere, set Edit connection › ADVANCED › herdr path (for example /home/dev/.cargo/bin/herdr).

When herdr on the host’s PATH and the running herdr server report different versions, Moshpit names which side is older—and refuses to restart the server into an older binary on PATH so an upgrade is never accidentally rolled back.