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.
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
| Agent Console | Chat | Live terminal |
|---|---|---|
![]() |
![]() |
![]() |
| Live Activity | Usage | Widgets |
|---|---|---|
![]() |
![]() |
![]() |
- 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.
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 |
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.pairScan 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.
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/.
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.
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.
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.












