ZingerLittleBee /Heeler
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
+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
#704Scheduled full iOS verification is failing4 comments · 2026-11-11#428Agent Notifications only say "Done": add Host, Tab, task title and an optional result preview2 comments · 2026-10-08#646Hardware keyboard: opening an Agent doesn't focus the input1 comments · 2026-11-06#606PTY reads can miss a reset socket for 20 seconds in package E2E1 comments · 2026-11-02#540Chat can't find Claude Code's input box when prompt suggestions are enabled1 comments · 2026-10-30#446Keep the last screen visible while reconnecting after a foreground return1 comments · 2026-10-12#290Per-pane name for sessions so the Agent list rows are distinguishable1 comments · 2026-09-08#278Reconnect immediately on network path changes and tune keepalive for expensive paths0 comments · 2026-09-04
Discussions
#623failing - “herdr server running” because it tries: ~/.config/herdr/herdr.sock0 comments · 2026-11-04#478iPhone Duo3 comments · 2026-10-19#279UI/UX2 comments · 2026-09-04#274Welcome to Heeler Discussions!0 comments · 2026-09-03
Latest release
0.1.19 (48) builds/0.1.19/48 2026-11-09Build 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":