Native iPhone and iPad console for herdr: watch and drive coding agents on your machines over SSH, in Herdr TUI or the Herdr desktop app (herdr-core), with a real libghostty terminal, native Chat, QR pairing, and push notifications when an agent needs you

★ 895⑂ 99👁 0⑃ 342● 388▤ 26
SwiftApache-2.0Created 2026-07-18heeler.bybee.dev
Download: 0.1.19 (48)builds/0.1.19/48 ↓482026-11-09
+8
Daily
+58
Weekly
895
stars
99
forks
0
watchers
342
prs
388
issues
26
releases

README

Heeler




A native iOS companion app for herdr (an agent-first terminal runtime) and tmux.










English | 简体中文 | 繁體中文 | 日本語



---

Heeler is an independent herdr mobile client and agent console for Claude Code, Codex, and other coding Agents on iPhone and iPad. Agents run on your own Hosts in Herdr TUI, the Herdr desktop app (herdr-core), or tmux; Heeler connects over SSH. Monitor multiple Agents across machines, sorted by who needs you, then open a live terminal or supported Chat conversation to send instructions.

 Screenshots

| Agent Console | Live terminal | Chat |
| --- | --- | --- |
|  |  |  |

| Keyboard | Changes | Terminals |
| --- | --- | --- |
|  |  |  |

| Skills | Hosts | Live Activity |
| --- | --- | --- |
|  |  |  |

| Usage | Widgets | Lock Screen widgets |
| --- | --- | --- |
|  |  |  |



View iPad screenshots

 Features

- Console — every Agent on every machine in one status-sorted list
  (Blocked first), filterable by Host, updated live.
- Herdr desktop and herdr-core — connect to the Herdr desktop app or
  headless herdr-core on macOS, Linux, and native Windows. The Console
  follows the desktop app's spaces and tabs, and live terminals, Chat, the
  Composer, New Agent, and New Workspace work there too
  (Read more).
- tmux — connect to a tmux 3.3+ server on macOS or Linux. Sessions,
  windows, and panes appear in the Console, live terminals size to fit your
  screen and stay within an open desktop terminal on the same window, Chat,
  the Composer, New Agent, New Workspace, and Worktrees work there too, and
  Claude Code hooks plus the optional Host Helper add Agent Status,
  notifications, Live Activities, and Usage
  (Read more).
- Attach — the Agent's real terminal rendered by libghostty: native
  scrollback, momentum touch scrolling that also drives full-screen TUIs,
  long-press selection, takeover of a stale terminal owner, and quietly
  collected web links to open later.
- Chat — read an Agent's conversation as native messages instead of a
  terminal screen, reply from the Composer, and answer a Blocked Agent with
  buttons; for Claude Code, Codex, Pi, Oh My Pi, Grok Build, OpenCode, and
  Antigravity CLI (Read more).
- Composer — draft locally with the full iOS keyboard (autocorrect, IME,
  dictation), then Send once; the tools keyboard adds Agent control keys,
  Agent Skills, reusable Snippets, and terminal appearance. Voice Input lets
  you speak to the Composer with your own speech service API key
  (Read more).
- 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 a 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 are generated
  on device, private keys stay in the Keychain, and the code pins the host
  key fingerprint.
- Notifications + Live Activities — end-to-end encrypted pushes when an
  Agent goes Blocked or Done, an

Top issues

Discussions

Latest release

0.1.19 (48) builds/0.1.19/48 2026-11-09
Build record

json
{
  "candidate": {
    "tag": "builds/0.1.19/48",
    "version": "0.1.19",
    "build": 48,
    "source": "f7ea4f28643ec08ef1e8d679744ac8f644cb9f2c",
    "plugin": "0.9.0",
    "bundle_id": "dev.bybee.heeler",
    "platform": "IOS"
  },
  "state": "valid",
  "run_id": "42679317915",
  "run_attempt": "1",
  "observed_at": "2026-11-09T19:14:59.895922+00:00",
  "ipa_sha256": "c817e4366bc8bbd7cb323c6e24df4a0960c6ac5c4df8f3def60c627e404d292f",
  "toolchain": "Xcode 27.2\nBuild version 27B52",
  "apple_build_id": "16655547-7cb4-4b6f-90e8-222a646cbc60",
  "apple_processing_state": 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON