# How to use herdr from your phone or tablet

> Reach your herdr agents from an iPhone, iPad or Android device: the herdr project's own app, Muxr and community clients, and how to set Muxr up.

Source: https://muxr.app/how-to/herdr-on-your-phone.html

Last updated: 15 November 2026

You can reach herdr sessions from a phone with the herdr project's own [mobile app](https://herdr.dev/mobile), with Muxr, or with a community client. The herdr mobile app says it ["works with herdr-core"](https://herdr.dev/mobile), as published on 15 November 2026.

Muxr works with the herdr 0.9.x server (0.9.0 to 0.9.5). herdr-core is not supported.

The herdr mobile app is free, made by the herdr project, and connects over SSH with no herdr account and no server of the project's in between. Its page also says "Herdr TUI isn't supported". If you run herdr-core, it is the better pick. Muxr is described below.

## Which herdr does Muxr work with?

Muxr works with the herdr 0.9.x server (0.9.0 to 0.9.5). herdr-core is not supported.

The Muxr server, `muxrd`, drives a `herdr` binary that you install yourself, over herdr's public Unix sockets. Version 0.9.0 is the supported floor and 0.9.5 is the newest release tested. `muxrd` also works with zellij and detects whichever of the two is installed.

## How do I set it up?

1. Install the Muxr app from the [App Store](https://apps.apple.com/app/muxr-zellij-herdr-client/id6815185967) or [Google Play](https://play.google.com/store/apps/details?id=com.it.f0x.muxr).
2. On the machine that runs herdr, install the server:

   ```
   curl -fsSL https://raw.githubusercontent.com/f0x-it-llc/muxr-core/main/install.sh | bash
   ```
3. Install Tailscale on the server and on your phone and sign both into the same tailnet. A LAN address or a public domain also work.
4. Run `muxrctl` on the server. Its setup wizard opens on first run, and `muxrd` finds herdr by itself.
5. In the app, tap the QR scan button on the Connect screen and scan the code that `muxrctl` shows.

The full walk-through, with screenshots, is the [quick start](https://muxr.app/docs.html).

## What can I do once connected?

You can create, rename and close sessions, tabs and panes, switch spaces on herdr, and type into a pane with a key bar for Ctrl, Alt, Esc and the arrows. Muxr shows the terminal that your agent runs in. It does not integrate with any specific agent.

On herdr, the agents list shows the coding agents running in a session, most urgent first: blocked, then done, working and idle, with a count for each.

For a watch-only device, create a read-only token in `muxrctl`. A read-only token can navigate tabs, panes and spaces and scroll, but it cannot type or change the session.

## Will my phone alert me when an agent is blocked?

Not yet. Push notifications are *Coming soon* in Muxr, and the app does not deliver notifications today.

If alerts are the main thing you need, pick a client that offers them now. According to their own pages, Collie sends push when an agent pauses or finishes, Sherpr gives on-device notifications, and Whip and herdrup offer push through a relay. The table below links each source.

## What other herdr phone clients are there?

The table lists herdr clients as published on 15 November 2026, the herdr project's own app first. "Not stated" means the client's pages say nothing about it. Muxr is free to download, and the free app is the full app with one server. Muxr Pro is a one-time $19.99 purchase, 50% off ($9.99) until January 13, 2027.

*herdr clients for phones and tablets*

| Client | Platforms | Price | Connection | Source | Fetched |
|---|---|---|---|---|---|
| herdr mobile app (from the herdr project) | iPhone, iPad, Android | Free | SSH to herdr-core | [herdr.dev/mobile](https://herdr.dev/mobile) | 15 Nov 2026 |
| Muxr | iPhone, iPad, Android | Free for one server; Pro unlocks more | gRPC over TLS to muxrd | [muxr-core](https://github.com/f0x-it-llc/muxr-core) | 15 Nov 2026 |
| Heeler for herdr | iPhone, iPad | Free | SSH | [App Store](https://apps.apple.com/us/app/heeler-for-herdr/id6797263135) | 15 Nov 2026 |
| Sherpr | Android | Not stated | SSH, no service in between | [F-Droid](https://f-droid.org/packages/org.sherpr.app/) | 15 Nov 2026 |
| Whip | Android, iOS | Not stated | SSH; opt-in push through a relay | [GitHub](https://github.com/kosumic/whip) | 15 Nov 2026 |
| herdrup | iPhone, iPad | Free | Needs herdrup's own fork of herdr; push through its relay | [GitHub](https://github.com/themartianapp/herdrup) | 15 Nov 2026 |
| Collie | Phone browser (PWA) | Not stated | A process on your computer, opened in the browser | [GitHub](https://github.com/AltanS/collie) | 15 Nov 2026 |
| herdr-mobile-relay | Phone browser (web app) | Not stated | A relay on each computer | [GitHub](https://github.com/0cv/herdr-mobile-relay) | 15 Nov 2026 |

For a longer list see [herdr mobile clients](https://muxr.app/best/herdr-mobile-clients.html), and for a side-by-side with the herdr app see [Muxr and the herdr mobile app](https://muxr.app/compare/herdr-mobile.html). More questions are in the [FAQ](https://muxr.app/faq.html).

**Related pages**

- [Muxr and the herdr mobile app compared](https://muxr.app/compare/herdr-mobile.html)
- [herdr mobile clients](https://muxr.app/best/herdr-mobile-clients.html)
- [Frequently asked questions](https://muxr.app/faq.html)
- [All how-to guides](https://muxr.app/how-to/)
