← all repositories
ZingerLittleBee/Heeler

Your coding agents, now in your pocket over plain SSH

Heeler is a native iOS console for herdr that shows every coding agent across your machines and pings you when one gets blocked.

★922 stars Swift Coding Assistants
Heeler
Velocity · 7d
+4.9
★ / day
Trend
↘cooling
star history

What it does

Heeler is a SwiftUI companion app for herdr, an agent-first terminal runtime. It lists every coding agent running on every machine you’ve paired, sorted by who needs attention (blocked agents first), and lets you attach to a live terminal, draft input with the real iOS keyboard, and send it once. It also handles the boring-but-critical parts: git changes and diffs per checkout, plain shell terminals, worktree creation, and file/photo attachments up to 64 MiB over SFTP.

The interesting bit

The transport is refreshingly unexotic: everything rides on plain SSH — herdr’s JSON API over a direct-streamlocal channel, one long-lived channel for events, and PTYs for interactive terminals. No server-side changes, no extra daemon. The terminal itself is libghostty with Metal rendering, so full-screen TUIs actually work with momentum touch scrolling. Push notifications are end-to-end encrypted, so the APNS relay can’t read them.

Key highlights

  • Status-sorted agent console across all hosts, updated live
  • Real libghostty terminal with scrollback, long-press selection, and takeover of stale sessions
  • QR pairing: keys generated on device, private keys stay in the Keychain, host key fingerprint pinned in the code
  • Lock-screen Live Activities and Dynamic Island tracking agents in real time
  • SSH jump host support for unroutable machines, with keys verified at both hops
  • 30 terminal themes, bundled JetBrains Mono and IBM Plex Mono, pinch to zoom

Caveats

  • Requires herdr (>= 0.7.5) running on the host and SSH with stream-local forwarding enabled — onboarding flags it if disabled
  • iOS 18+ only; native Windows hosts need herdr >= 0.9.3 and manual setup
  • The author openly notes it was built for personal use first: expect rough edges and fast iteration

Verdict

If you run herdr and want to babysit coding agents from your phone without a browser-based remote desktop, this is a genuinely native take. If you’re not in the herdr ecosystem, there’s nothing here for you — it’s a companion app, not a general SSH client.

Frequently asked

What is ZingerLittleBee/Heeler?
Heeler is a native iOS console for herdr that shows every coding agent across your machines and pings you when one gets blocked.
Is Heeler open source?
Yes — ZingerLittleBee/Heeler is open source, released under the Apache-2.0 license.
What language is Heeler written in?
ZingerLittleBee/Heeler is primarily written in Swift.
How popular is Heeler?
ZingerLittleBee/Heeler has 922 stars on GitHub and is currently cooling off.
Where can I find Heeler?
ZingerLittleBee/Heeler is on GitHub at https://github.com/ZingerLittleBee/Heeler.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.