Skip to content
ZingerLittleBeePublic

About

Native iPhone and iPad console for the coding agents on your own machines. Works with herdr and tmux over SSH.

Topics

Resources

Contributing

Stars

915 stars

Watchers

0 watching

Forks

Latest commit

 

History

4,952 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Heeler logo

Heeler

Download on the App Store Available on TestFlight

The iPhone and iPad console for the coding agents running on your own machines.

Works with Herdr TUI, the Herdr desktop app (herdr-core), and tmux. Rex is coming soon.

GitHub stars CI License: Apache 2.0 Swift iOS App Store

ZingerLittleBee%2FHeeler | Trendshift

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


Heeler is an independent, open-source agent console and herdr mobile client for Claude Code, Codex, and other coding Agents on iPhone and iPad. Agents keep running on your own machines in Herdr TUI, the Herdr desktop app (herdr-core), or tmux, and Heeler connects to them over SSH, so your code never passes through our servers. See which Agent needs you, answer in native Chat or the real terminal, and get an encrypted notification the moment one goes Blocked or Done.

Website · Documentation · Privacy · Changelog

Screenshots

Agent Console Chat Live terminal
Agent Console listing Agents across Hosts with their status on iPhone Chat showing an Agent's conversation as native messages on iPhone Agent's live terminal with Direct Input on iPhone
Live Activity Usage Widgets
Lock-screen Live Activity tracking Agents on iPhone Usage tab with 30 days of estimated API cost, Usage Limits, and a daily chart on iPhone Home Screen with Usage and Usage Limits widgets in small and medium sizes on iPhone
More screenshots
Keyboard Changes Terminals
Agent Direct Input with shortcuts and a full Terminal Keyboard on iPhone Changes listing a Checkout's staged and unstaged files on iPhone Terminals tab listing shell panes by Host and Workspace on iPhone
Skills Hosts Lock Screen widgets
Composer Skills suggestions on iPhone Hosts tab grouping Hosts by connection status with their latency on iPhone Lock Screen with Usage and Usage Limits accessory widgets on iPhone

Heeler in a floating iPad window

View iPad screenshots

Features

  • Console: every Agent on every machine in one live list, sorted with Blocked first and filterable by Host.
  • Chat: an Agent's conversation as native messages, with buttons to answer a Blocked Agent. For Claude Code, Codex, Pi, Oh My Pi, Grok Build, OpenCode, and Antigravity CLI. Chat guide
  • Live terminal: the Agent's real terminal, rendered by libghostty with native scrollback and selection, and a plain shell in the Agent's directory.
  • Notifications and Live Activities: an end-to-end encrypted push when an Agent goes Blocked or Done, and your Agents on the Lock Screen and Dynamic Island. The relay cannot read the content. Privacy
  • Usage: Claude Code and Codex Usage Limits with their reset times, up to 30 days of Token Usage with its estimated API cost, and Home Screen and Lock Screen widgets. Usage guide
  • Composer: draft with the full iOS keyboard or by voice, then Send once. The tools keyboard adds Agent control keys, Skills, and Snippets, and you can attach a photo or a file up to 64 MiB. Voice Input guide
  • Reach from anywhere: Tailscale, ZeroTier, and EasyTier are built into the app, so the phone needs no VPN app. A Jump Host covers machines you cannot route to, and a Host can have several routes. Overlay networks · Jump Host · Routes
  • Also: QR pairing, Worktrees, a Changes view of staged and unstaged files, 30 themes, and iPad with Magic Keyboard shortcuts, multiwindow, and drag and drop.

Installation

Install Heeler from the App Store or TestFlight. The machine needs SSH turned on and one of these backends:

Backend Runs on Guide
Herdr TUI macOS, Linux Pair by scanning
Herdr TUI 0.9.3 or newer Native Windows Windows setup
Herdr desktop app or herdr-core macOS, Linux, native Windows Connect herdr-core
tmux 3.3 or newer macOS, Linux Connect tmux
Rex Coming soon

Adding a machine

Turn on the machine's OpenSSH server first (macOS: System Settings > General > Sharing > Remote Login).

Scan a Pairing Code. On a macOS or Linux machine running Herdr TUI (herdr 0.7.5 or newer, Node 20 or newer), run:

herdr plugin install ZingerLittleBee/Heeler --ref plugin --yes
herdr plugin action invoke heeler.pair

Scan the code it shows and the machine is added as a Host, with its addresses, host key fingerprint, and SSH key in place. On a machine without herdr, such as one that runs only herdr-core or tmux, npx -y heeler-pair@latest shows the same code (Node 20 or newer, Heeler after 0.1.20). Pairing guide

Or enter the address. This works for every backend. In Hosts, tap +, enter the address and your SSH user, and Heeler lists what the machine runs: Herdr TUI, herdr-core, and each tmux server. One Host can carry several of them. Connect herdr-core · Connect tmux · Windows setup

Away from home. Reach the machine over a built-in overlay network (Tailscale, ZeroTier, EasyTier), a Jump Host, or Cloudflare Tunnel, and give the Host several routes so it works at home and away.

How it connects

Heeler needs only SSH access and a running backend: no server changes, and no extra packages to connect.

  • Herdr TUI: herdr's JSON API over stream-local forwarding to herdr.sock, with terminals on an SSH PTY. OpenSSH allows the forwarding by default, though SELinux on Fedora or RHEL can deny it.
  • herdr-core: one framed link to the core's socket.
  • tmux: control mode, attached per Pane alongside your desktop clients, with Claude Code hooks reporting Agent status.

On macOS and Linux Hosts, notifications, Live Activities, and Usage come from the Heeler plugin on Herdr TUI and from the optional Host Helper on herdr-core and tmux. Update the plugin and Host Helper

Private keys are generated on the device and stay in the Keychain. A Host's key is pinned by its Pairing Code or confirmed by fingerprint on first connect. The decisions behind the transport are recorded in docs/adr/.

Opening an Agent from another app

heeler://agent?host=my-mac&session=work&pane=w1%3Ap1

host is a saved Host's address or name (case is ignored), session is the herdr session (leave it out for the default), and pane is the pane id (leave it out to open the Console). Percent-encode each value, with %20 for a space rather than +. A link that matches no saved Host, or more than one, opens the Console.

Contributing

Heeler is SwiftUI on iOS 18+, with SSH from the repository-local Packages/HeelerSSH (libssh2 and OpenSSL) and terminal rendering from libghostty-spm. Issues and PRs are welcome: CONTRIBUTING.md covers layout, build, test, and conventions.

Status

Released on the App Store. It is not yet available in every country or region; where it is missing, the TestFlight build stays available. Built for personal use first and shaped by daily driving, so expect rough edges and fast iteration. Not affiliated with the herdr project.

About

Native iPhone and iPad console for the coding agents on your own machines. Works with herdr and tmux over SSH.

Topics

Resources

Contributing

Stars

915 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages