Skip to content
ColliePWA

Herdr mobile app for iOS and Android

ColliePWA is a mobile client for Herdr on iPhone, iPad and Android. Your own machine serves the web app. It requires no account and no download from the App Store or Google Play. Open it on your phone, pair it once, and control your Herdr workspaces.

Try the demo

Herdr

Set it up in three steps.

  1. On the computer that runs Herdr, start the Herdr server. Then run herdr plugin install AltanS/collie and herdr plugin action invoke start --plugin herdr.collie. Herdr 0.7.0 or newer is required.
  2. Open the address it gives you on your phone, and pair the phone. The install guide shows each step.
  3. Add ColliePWA to your home screen. Follow the steps below for iOS and Android.

No plugin? Install Collie with the script instead. collie start finds a running Herdr on its own. On a machine with only the new Herdr app, it drives the Herdr core.

On your phone, ColliePWA lives on the home screen. This is how you put it there:

Open the page in Safari and tap ⋯ next to the address. If Share sits on the bar, tap it instead.

iOS

The Herdr iOS app: ColliePWA on iPhone and iPad.

  • Open your ColliePWA address in Safari. Tap ⋯ next to the address bar, tap Share, scroll down and tap Add to Home Screen, leave Open as Web App on, then tap Add. With the Top or Bottom tab layout, or on older iOS versions, Share sits on the bar itself. On iOS 16.4 or newer, Chrome, Edge and Firefox also show Add to Home Screen in their share menus.
  • The home screen app uses its own storage, separate from Safari. Pair it again inside the app.
  • Push notifications require iOS or iPadOS 16.4 or newer, an HTTPS address and the home screen icon. Enable them under Settings, Alerts, inside the app. See voice and push.
  • We test ColliePWA in a WebKit build. We have not checked every step on an iPhone yet.

Android

The Herdr Android app: ColliePWA on Android.

  • Open your ColliePWA address in Chrome. Go to Settings and tap Install on the top card. If that card does not appear, open Chrome's menu, tap Add to home screen, then tap Install. Firefox and Samsung Internet provide Add to Home screen in their main menus.
  • Push notifications work in a standard browser tab over HTTPS. Installing adds the home icon and full-screen mode. See voice and push.
  • We test on-device speech recognition in Chrome on Android.

ColliePWA

What you get on your phone.

  • Every Herdr workspace, tab and pane in one list. Herdr says which panes hold an agent, and the ones that need you sit on top.
  • Herdr pushes state changes, so a pane that just asked a question moves up without waiting for the next scheduled check.
  • Read the pane screen and reply. Send Esc, Ctrl and arrow keys from the Keys tray, pick a plan option, or speak your reply.
  • Open, rename and close tabs, and open a workspace, from the phone.
  • Get a push notification when an agent asks a question or finishes. Push needs an HTTPS address. See voice and push.
  • Nothing goes through a cloud service. ColliePWA listens on loopback only. Your phone reaches it through a private front door such as Tailscale, after you pair it.

Herdr · SSH

Mobile client, store app or SSH?

Herdr's own docs say you can use Herdr from a phone with any SSH client, and they name Moshi for iPhone. That route runs the Herdr terminal on a small screen. ColliePWA shows a list of your agents and touch controls instead. You can use both.

Do you want an app from a store? Herdr Mobile is on Google Play. herdrup, Heeler and Moshi are on the App Store. These are separate projects, not part of ColliePWA.

ColliePWA is a web app, not a native app. It needs your computer to stay on, and your phone needs a path to it. It has no watch app. The comparison with Moshi lists both sides.