Heeler
Native iPhone and iPad console for the coding agents on your own machines. Works with herdr and tmux over SSH.
What is Heeler?
Native iPhone and iPad console for the coding agents on your own machines. Works with herdr and tmux over SSH.
Overview of Heeler
What it is
Heeler is a native iOS companion app for herdr, an agent-first terminal runtime. It serves as an agent console: a dashboard of every coding agent running on your machines, sorted by who needs you. You can open an agent to read and steer its live terminal, draft with the full iOS keyboard in a native Composer, and send the complete message once — all over plain SSH.
Key features
- Console: every agent on every machine in one status-sorted list (blocked first), filterable by host, updated live.
- Attach: the agent's real terminal rendered by libghostty with native scrollback, momentum touch scrolling, long-press selection, takeover of a stale terminal owner, and collected web links.
- Composer: draft locally with the full iOS keyboard (autocorrect, IME, dictation), then send once; tools keyboard adds agent control keys, agent skills, reusable snippets, and terminal appearance.
- Terminal: open a plain shell in the agent's directory, with Text and Keys modes and one reused tab per workspace.
- Attachments: stage a photo or file up to 64 MiB onto the host over SFTP and insert its path into the draft.
- QR pairing: scan a Pairing Code to add a machine; keys generated on device, private keys stay in Keychain, code pins host key fingerprint.
- Notifications + Live Activities: end-to-end encrypted pushes when an agent goes Blocked or Done, and a lock-screen / Dynamic Island banner tracking agents in real time; relay cannot read content.
- Worktrees: start an agent on a clean checkout of the workspace's repo.
- Appearance: System, Light, or Dark; 30 terminal themes with separate Light and Dark slots; bundled JetBrains Mono and IBM Plex Mono; pinch to zoom.
- Jump Host: reach unroutable machines through an SSH jump, with keys verified at both hops.
Use cases
- Monitor and interact with coding agents running on remote machines from an iOS device.
- Pair a new host via QR code and manage SSH keys securely.
- Receive push notifications when an agent is blocked or done, and track agents via Live Activities.
- Draft and send messages to agents using the full iOS keyboard, with support for attachments and snippets.
- Open a plain terminal shell in the agent's working directory.
- Use overlay networks (Tailscale, ZeroTier, EasyTier) or SSH jump hosts to reach machines that are not directly routable.
Getting started
Install Heeler from the App Store or TestFlight. On a macOS or Linux machine running herdr (Node >= 20, herdr >= 0.7.5, OpenSSH server on), run: bash herdr plugin install ZingerLittleBee/Heeler/plugin --ref main --yes herdr plugin action invoke heeler.pair Scan the Pairing Code QR it shows to add the machine as a host.
License and pricing
License: Apache-2.0. Pricing: open source (free).
Based on the project's public README and repository metadata.