Herdr on iPhone and iPad: Herdr vs Tmux, and Herdr in Shell Drop

11 November 2026 · Daniel Bilsborough · Reviewed 11 November 2026

Herdr is an open-source terminal workspace manager built for AI coding agents. Like Tmux, it keeps your terminals running on the server after you disconnect. On top of that it knows which agent is working, which is blocked waiting for an answer, and which is idle.

Shell Drop works with Herdr from version 5.2.7. It spots Herdr by itself, names each tab after its Herdr workspace, goes straight back into the session after a dropped connection, and sends “Agent needs you” for every agent in every pane.

What Herdr is

Herdr is a single program written in Rust, free under the Apache 2.0 licence, from herdr.dev. It runs inside the terminal you already use, so on a server you start it over SSH the same way you would start Tmux. Work is arranged in workspaces, usually one per project, with tabs and panes inside them and a sidebar that lists every agent and its state.

Herdr vs Tmux

Both keep a terminal session alive on the server so the phone can come and go. The difference is how much they know about what runs inside.

TmuxHerdr
Made forAny terminal work, since 2007AI coding agents
Keeps running after you disconnectYesYes
After the machine restartsSessions are gone, unless you add a plugin such as tmux-resurrectRestores the layout and can resume supported agent sessions
Agent statusNone built inEach pane marked working, blocked or idle, with an agent sidebar
LayoutSessions, windows and panesWorkspaces, tabs and panes
Keys and mousePrefix keys on Ctrl-b; mouse off until you add set -g mouse onPrefix keys on Ctrl-b; mouse on, with click, drag and split
ScriptingThe tmux command and its scriptingA command line and socket API that agents can use
InstallPreinstalled or one package away on most Mac and Linux machinesbrew install herdr or the install script
LicenceISCApache 2.0
In Shell DropSupportedSupported from 5.2.7

Tmux is the long-standing default and is on almost every server, and the Tmux cheat sheet covers it on a phone. Herdr is newer and built around agents; people running several agents at once tend to reach for it for the sidebar and the agent states. Both can run side by side on one server, and Shell Drop handles either.

Set up Herdr for Shell Drop

  1. On the server, install Herdr. On a Mac:
    brew install herdr
    On Mac or Linux, the install script from herdr.dev works too:
    curl -fsSL https://herdr.dev/install.sh | sh
  2. In Shell Drop, connect to the server with a saved connection, using a password or an SSH key. The SSH keys on iPhone guide covers keys.
  3. Start Herdr in the project folder:
    cd ~/projects/my-app
    herdr
  4. Start an agent in a pane, such as claude or codex, and give it its task.
  5. Lock the phone, or detach with Ctrl-b q. The agents keep working. To get back in, run herdr, or herdr session attach <name> for a named session.

There is nothing to set up on the server for Shell Drop. Herdr turns on mouse scrolling and names the window after its workspace by itself, and Shell Drop reads both. Its options are in Settings > Terminal > Herdr.

What Shell Drop does with Herdr

The agents themselves are covered on Claude Code on iPhone and Codex on iPhone, and the AI agents on a Mac mini page sets up an always-on machine for them.

Questions

Does Shell Drop work with Herdr?

Yes, from Shell Drop 5.2.7. Shell Drop spots Herdr by itself, names each tab after its Herdr workspace, goes back into the Herdr session after a dropped connection, and sends Agent needs you for every agent in every pane.

Do I need to configure Herdr for Shell Drop?

No. Herdr turns on mouse scrolling and names the window after its workspace by itself, and Shell Drop reads both. The Shell Drop options are in Settings > Terminal > Herdr.

Is Herdr a replacement for Tmux?

Herdr does the same core job as Tmux, keeping terminal sessions running on the server after you disconnect, and adds agent states, an agent sidebar and an API that agents can drive. Both can be installed on the same server, and Shell Drop works with both.

Do my agents keep running in Herdr when I lock my iPhone?

Yes. The agents run in Herdr’s background server on the machine, so locking the phone or losing signal only drops the SSH connection. Reconnect and run herdr to pick up where you left off; Shell Drop does that for you after a dropped connection.

How do I install Herdr?

On a Mac, brew install herdr. On Mac or Linux, the install script from herdr.dev: curl -fsSL https://herdr.dev/install.sh | sh. Then run herdr in your project folder.

Is Herdr free?

Yes. Herdr is open source under the Apache 2.0 licence. Shell Drop is free on the App Store.

Get Shell Drop on the App Store QR code for Shell Drop on the App Store Reading on a computer? Scan the code with your iPhone camera.