// readme

herdrup

Answer your AI coding agents from your phone.

herdrup is an iOS client for herdr β€” a calm status board for the coding agents running on your machine, with a real terminal one tap behind each. When an agent needs you, you see it at a glance and can reply from anywhere.

⬇ Download on the App Store Β· 🌐 herdrup.app

The framing is a herdr client that contains a terminal, not a terminal app that happens to run herdr. A generic SSH terminal renders a character grid and cannot know what a pane or an agent is; herdr’s JSON API exposes both, so panes and agents become real UI objects instead of pixels.

What it does

  • Status board β€” every agent grouped by what it needs: needs you (amber), working, done, stopped. Colour is meaning, not decoration β€” the one signal that matters reads instantly. On a herdr that advertises events_v2, rows change as status events arrive, including agents on federated machines the coordinator relays; the list is re-fetched every 30 s as a backstop and after a stream reconnect. An older herdr is polled every 5 s.…