Heeler for herdr
Your herdr agent console
Free · Designed for iPad. Not verified for macOS.
Heeler is a native iOS companion for herdr, an agent-first terminal runtime.
See every coding agent running on your machines in one priority-sorted console. Open an Agent to read and steer its live terminal, draft prompts locally with the standard iOS keyboard, and send complete messages when you are ready.
FEATURES
• Unified Agent Console across multiple Hosts
• Live terminal rendering with native scrollback and touch scrolling
• Native Composer with autocorrect, IME, dictation, and attachment staging
• Direct Agent controls for Esc, Tab, arrows, Enter, and more
• QR pairing with an on-device Ed25519 key
• End-to-end encrypted notifications when an Agent is Blocked or Done
• Worktree-based Agent launches
• SSH Jump Host support
• Independent light and dark terminal themes
PRIVACY
Heeler has no analytics or account system. SSH credentials stay in the iOS Keychain. Live terminal output and prompts travel directly between your device and your own Host over SSH. Notification content is encrypted on your Host before passing through the push relay.
REQUIREMENTS
Heeler requires access to a machine running herdr 0.7.5 or later with OpenSSH Remote Login enabled. Install the included herdr plugin to scan a Pairing Code and enable Agent Notifications.
Heeler is an independent project and is not affiliated with the herdr project.
more What's new in 0.1.15:
• Chat with Claude Code, Codex, Pi, and Oh My Pi in a native conversation view, with readable replies, tool activity, and code changes.
• Send messages and skills from Chat, respond to supported approval and question prompts, and switch to the terminal whenever you need it.
• Keep saved conversations available offline. Collapse completed steps and preview images without losing your place.
• Customize Chat fonts and text size alongside your app and terminal appearance in Settings › Appearance.
• Improved conversation layout, Markdown tables, and Agent switching, with fixes for freezes when navigating between Agents.
0.1.15 新变化:
• 新增原生 Chat,支持 Claude Code、Codex、Pi 和 Oh My Pi,清晰查看回复、工具执行过程和代码改动。
• 在 Chat 中发送消息和技能,处理支持的授权与提问,随时切换到终端。
• 离线查看已保存的对话,折叠已完成的步骤,并预览对话中的图片。
• 在「设置 › 外观」中统一调整 Chat 字体、文字大小,以及应用和终端外观。
• 改善对话排版、Markdown 表格和 Agent 切换体验,修复切换与返回时可能出现的卡顿。
0.1.15 1 hr ago
What's new in 0.1.14:
• Reach a Host through Tailscale, ZeroTier, or EasyTier without turning on a VPN. Add a network in Settings › Overlay Networks and choose it for a Host; Heeler joins it only while open and only for its own connections. Supports EasyTier config servers and ZeroTier moons and custom planets.
• Pick a Host from a Tailscale or EasyTier network instead of typing its address, or add a machine as a Host from its network's screen.
• Give a Host several routes, such as its LAN address at home and an overlay network or Jump Host elsewhere. Heeler tries them all on each connection and keeps the first that answers. Pairing adds every address from the Pairing Code, and a Host's key is trusted once for all its routes.
• Host details show which route is in use, or why each route failed, with Reconnect and Stop on the status card. New Hosts start from Add Route.
• Cancel a slow connection at once: connecting a network, choosing from a tailnet, Host checks, and connecting Hosts can all be stopped without waiting for a timeout.
• Redesigned Overlay Networks settings: a switch per network, a status card with this device's address, and searchable machines. ZeroTier networks add Diagnostics with Copy All.
• Group the Agents list By Workspace and collapse Workspaces to focus on one project, with status counts still visible. The choice is remembered.
• Back to Console in an Agent's More menu returns to the Console without needing the edge swipe.
• Type Korean straight into the terminal: syllables now compose correctly with both the software and hardware keyboards.
• The animation on working Agents uses far less CPU, keeping the phone cooler. Acknowledgements show each component's source and version.
• Removing a Host now ends its Live Activity and, when the Host is connected, stops its notifications to this device.
• Better with herdr 0.9.4: New Agent with long Arguments on macOS no longer fails, slow connections no longer type stray characters into Agents and shells, and Agent cards keep the Host's sidebar fields and order (update the Heeler plugin to 0.6.1). When the plugin is turned off, the Host's page always shows the command to turn it back on.
• Clearer errors: a failed attach quotes herdr's own error, and removing a Worktree blocked by submodules says so and offers the command to force it.
• Fixed Tailscale sign-in needing extra taps and not showing Connected afterwards, host key trust for Hosts added from a network's machine list, and Close Agent and Close Terminal confirmations floating mid-screen instead of appearing from the More button.
0.1.14 新变化:
• 无需开启 VPN,即可通过 Tailscale、ZeroTier 或 EasyTier 访问 Host。在「设置 › Overlay Networks」中添加网络并为 Host 选择;Heeler 仅在打开时加入网络,且只用于自身连接。支持 EasyTier 配置服务器,以及 ZeroTier 的 moon 和自定义 planet。
• 可直接从 Tailscale 或 EasyTier 网络中选择 Host,无需手动输入地址;也可在网络页面将机器添加为 Host。
• 一个 Host 可设置多条路由,例如在家用局域网地址,在外走 Overlay Network 或 Jump Host。每次连接会同时尝试所有路由,并使用最先连通的一条。配对时会添加配对码中的全部地址,Host 的密钥只需信任一次即适用于所有路由。
• Host 详情显示当前使用的路由,或每条路由各自的失败原因,状态卡上可直接重连或停止。新建 Host 从「Add Route」开始。
• 连接缓慢时可立即取消:连接网络、从 tailnet 选择机器、Host 检查和正在连接的 Host 都可直接停止,无需等待超时。
• 重新设计 Overlay Networks 设置:每个网络有独立开关,状态卡显示本设备地址,机器列表支持搜索。ZeroTier 网络新增诊断页面,可一键复制全部信息。
• Agents 列表可按 Workspace 分组,并可折叠 Workspace 专注于单个项目,状态计数仍然可见,选择会被记住。
• Agent 的「更多」菜单新增「Back to Console」,不用边缘滑动手势也能返回 Console。
• 可直接在终端中输入韩文:无论使用软键盘还是硬件键盘,音节都能正确组合。
• 运行中 Agent 的动画大幅降低 CPU 占用,手机发热更少。「致谢」页面显示各组件的来源和版本。
• 移除 Host 时会结束其实时活动;若 Host 处于连接状态,还会停止其向本设备发送通知。
• 更好地适配 herdr 0.9.4:macOS 上带长参数新建 Agent 不再失败;慢速连接下不再向 Agent 和 shell 输入多余字符;Agent 卡片会保留 Host 侧边栏的字段和排序(请在每台 Host 上将 Heeler 插件更新到 0.6.1)。插件被关闭时,Host 页面始终会给出重新启用的命令。
• 错误提示更清晰:连接终端失败时会显示 herdr 自身的错误信息;移除因子模块无法删除的 Worktree 时会说明原因,并提供强制删除的命令。
• 修复 Tailscale 登录需要多次点击、登录后不显示已连接,从网络机器列表添加的 Host 无法信任主机密钥,以及「关闭 Agent」和「关闭终端」的确认框浮在屏幕中间、而不是从「更多」按钮弹出的问题。
0.1.14 17 Oct
What's new in 0.1.13:
• Added native Windows Host support over SSH with herdr 0.9.3 or newer, including named sessions and live Agent and shell terminals. Pairing, Changes, Skills, file uploads, and notification registration are unavailable on Windows.
• A new Setup Guide helps configure macOS, Linux, and Windows Hosts, with copyable pairing commands.
• Host details show the Heeler plugin version and setup or update instructions. Fixed notifications mixing across Hosts and sessions; update each Host's plugin to 0.6.0 or newer for session isolation.
• Open an Agent from another app using a heeler://agent link.
• Composer now supports autocorrect and spell checking.
• Agent and terminal screens have folding glass navigation buttons. Improved back gestures and fixed terminal and tab bar behavior when resizing iPad windows.
• Long-press an Agent to close its pane, tab, or Workspace, or a Host to duplicate its settings. New Hosts connect automatically after their key is trusted and checks pass.
• Changes defaults to Unified diffs. Fixed iPad layout switching and large diffs stalling during brief SSH send interruptions.
• Fixed connections using an outdated system herdr, misplaced input bars on iPhone, and hard-to-read terminal status buttons.
0.1.13 新变化:
• 新增原生 Windows Host 的 SSH 支持,需要 herdr 0.9.3 或更新版本,可使用命名会话及 Agent、shell 实时终端。Windows 暂不支持配对、Changes、Skills、文件上传和通知注册。
• 新增 Setup Guide,帮助配置 macOS、Linux 和 Windows Host,提供可复制的配对命令。
• Host 详情显示 Heeler 插件版本及配置、更新指引。修复不同 Host 和会话的通知相互干扰,请将各 Host 的插件更新至 0.6.0 或更新版本以启用会话隔离。
• 支持从其他应用通过 heeler://agent 链接打开 Agent。
• Composer 新增自动纠正和拼写检查。
• Agent 和终端页面新增可折叠的玻璃导航按钮。改进返回手势,修复调整 iPad 窗口大小时的终端和标签栏问题。
• 长按 Agent 可关闭其 pane、tab 或 Workspace,长按 Host 可复制连接设置。新 Host 的密钥获信任且检查通过后自动连接。
• Changes 默认使用 Unified diff,修复 iPad 布局切换及 SSH 短暂无法发送时大型 diff 卡住的问题。
• 修复误用旧版系统 herdr 导致连接失败、iPhone 输入栏位置偏高,以及终端状态按钮文字不清晰的问题。
0.1.13 10 Oct
What's new in 0.1.12:
- Changes shows an Agent's Checkout's uncommitted changes, grouped into Conflicts, Staged, Changes, and Untracked with file statuses and line counts. Open it from More, the branch or totals above the input, or Worktree details.
- File diffs show line numbers and word-level highlights. Wide iPad views offer Side by Side and Unified layouts, remembering your choice and reading position.
- Copy paths, lines, or diff hunks, or insert file and line references into Composer or Direct Input without losing your draft or input mode.
- The Agents list, switcher, and status line show Checkout line totals, or file counts when no lines changed. The status line also shows the branch and upstream ahead/behind counts.
- Changes refreshes after an Agent stops working or a Host reconnects, and supports pull-to-refresh. Open diffs stay in place with a Reload notice when files change; timeouts preserve existing content.
- Git reads use the existing SSH connection without modifying the Checkout, running hooks, or writing to the index.
- The Dynamic Island pairs Working, Blocked, and Done counts with distinct glyphs, showing the most urgent status first. Expanded, it names that status and marks each Agent with its glyph.
- Fixed iPad's search field overlapping short Agents lists and blank areas of Changes file rows not responding to taps.
0.1.12 新变化:
- 新增 Changes,查看 Agent 所在 Checkout 的未提交改动,按冲突、已暂存、未暂存和未跟踪分组,显示文件状态与增删行数。可从 More、输入栏上方的分支或统计数字,以及 Worktree 详情进入。
- 文件 diff 支持行号和词级高亮。iPad 宽视图可切换左右对照与 Unified 布局,记住偏好并保留阅读位置。
- 可复制路径、代码行或 diff 片段,也可将文件与行引用插入 Composer 或 Direct Input,保留草稿和输入模式。
- Agents 列表、切换器和状态栏显示 Checkout 增删行数,无行数变化时显示文件数量;状态栏同时显示分支及相对上游领先、落后的提交数。
- Agent 停止工作或 Host 重连后自动刷新,也支持下拉刷新。文件变化时保留已打开的 diff 并提示 Reload;超时保留已有内容。
- 通过现有 SSH 连接读取 Git,不修改 Checkout、不运行 hooks、不写入索引。
- 灵动岛用不同符号标注 Working、Blocked 和 Done 的数量,优先显示最需关注的状态;展开后显示状态名称及各 Agent 的对应符号。
- 修复 iPad 短 Agents 列表被搜索框遮挡,以及 Changes 文件行空白区域点击无响应的问题。
0.1.12 2 Oct
What's new in 0.1.11:
- The Console now has Agents, Terminals, Hosts, and Settings tabs, and reopens the list you last used.
- Terminals lists every Host's shells as one card per Workspace. Open a new shell in any Workspace, swipe one to close it, and pull the list down to search it.
- Host headers show their connection state at a glance. A Host that can't connect opens a sheet with the failure and Retry, and the Hosts list groups Hosts by what they need.
- On iPad, the list sits in a sidebar beside the terminal, and Hosts, Settings, New Agent, and New Terminal open as centered sheets sized to their content.
- A Shell Terminal's input row adds a keyboard button to hide or bring back the keyboard.
- Pairing recognizes Tailscale SSH on the Pairing Code's port and points you to ssh_port in pair.json instead of reporting a network problem.
- Fixed open sheets such as New Agent losing what you typed when you rotate a Max iPhone or resize an iPad window, and terminals starting under the window controls in a narrow iPad window.
0.1.11 新变化:
- Console 新增 Agents、Terminals、Hosts 和 Settings 四个标签页,并会回到上次使用的列表。
- Terminals 按 Workspace 分卡片列出所有 Host 的 Shell:可在任意 Workspace 新开 Shell、滑动关闭 Shell,下拉列表即可搜索。
- Host 标题直接显示连接状态。无法连接的 Host 会弹出面板显示失败原因并提供重试;Hosts 列表按需要处理的情况分组。
- iPad 上列表以侧边栏显示在终端旁;Hosts、Settings、新建 Agent 和新建 Terminal 以居中面板打开,高度随内容调整。
- Shell Terminal 输入栏新增键盘按钮,可隐藏或重新唤出键盘。
- 配对时能识别在配对码端口上应答的 Tailscale SSH,并提示在 pair.json 中设置 ssh_port,不再误报为网络问题。
- 修复旋转 Max 尺寸 iPhone 或调整 iPad 窗口大小时,New Agent 等已打开的面板丢失输入内容,以及 iPad 窄窗口中终端被窗口控制按钮遮挡的问题。
0.1.11 28 Sept
What's new in 0.1.10:
- Swipe an Agent left to close it, or right to pin it. Swipe all the way to act at once.
Closing always asks first, and a split tab keeps its other panes.
- Create a Workspace in New Agent with just a name. It opens in the Host's home folder
unless you choose a directory.
- New Agent tabs take the Agent's name instead of "Tab N". Enter a Tab Name to choose
your own.
- omp Agents show the model, context usage, spend, and token rate in a strip above the
terminal.
- Pair with a Host whose SSH runs on a non-default port, set in the plugin's pair.json.
This lets OpenSSH run alongside Tailscale SSH.
- Fixed the first message to a newly started Agent failing to send, the "Trust this
Host?" prompt disappearing when you add a Host, Direct Input sending a word twice, and
pairing choosing a Docker network address by default.
0.1.10 新变化:
- 在 Agent 列表中左滑关闭、右滑置顶 Agent,滑到底直接生效。关闭前都会先确认;如果所在
Tab 还有其他 Pane,只关闭该 Agent 所在的 Pane。
- 新建 Agent 时只填名称即可创建 Workspace,未选择目录时默认使用 Host 的主目录。
- 新 Agent 的 Tab 以 Agent 名称命名,不再显示 "Tab N";填写 Tab 名称即可自定义。
- omp Agent 的终端上方新增信息条,显示模型、上下文占用、花费和生成速度。
- 支持通过 pair.json 为 Host 配置非默认 SSH 端口进行配对,方便 OpenSSH 与 Tailscale SSH
共存。
- 修复新启动的 Agent 首条消息发送失败、添加 Host 时「Trust this Host?」提示消失、Direct
Input 重复输入单词,以及配对时默认选中 Docker 网络地址的问题。
0.1.10 23 Sept
What's new in 0.1.8:
- Heeler comes to iPad with a two-column Console, portrait and landscape layouts, and multiple windows in Stage Manager.
- Drag text and images into Compose on iPad.
- Use hardware keyboard shortcuts to switch Agents, search, start an Agent, and send your draft.
- The Terminal keyboard fills the available width without getting taller. Direct Input buttons now have consistent sizing and spacing.
- Fixed saved Agent List Fields blocking edits after switching builds, and pairing errors disappearing before you could read them.
0.1.8 新变化:
- Heeler 首次推出 iPad 版,支持双栏 Console、横竖屏布局和台前调度多窗口。
- 在 iPad 上可将文字和图片拖入 Compose。
- 新增外接键盘快捷键,可切换 Agent、搜索、新建 Agent 和发送草稿。
- Terminal 键盘铺满可用宽度,高度保持不变;Direct Input 按钮的尺寸和间距统一。
- 修复切换构建版本后 Agent List Fields 无法编辑,以及配对错误提示过早消失的问题。
0.1.8 14 Sept
What’s new:
- Customize the fields on Agent list cards, with herdr sidebar fields shown by default. Live Activities use the same fields. Remember to update the Heeler plugin.
- When Composer is hidden, a link icon appears on the side if the terminal contains URLs.
- Fixed Host connections when using non-POSIX shells.
- Navigate between your messages and return to the latest output, even while the Agent is working. Manual scrolling stops automatic navigation.
- Improved multiline paste handling and terminal layout updates.
- Improved discovery of Agent CLIs installed through common package managers.
新变化:
- Agent list 卡片支持自定义字段(默认显示 herdr 侧栏字段),实时活动也会显示相同字段,记得更新 Heeler 插件。
- 隐藏 Composer 后,如果 terminal 中有链接,侧边会显示 url 的 icon。
- 修复使用非 POSIX Shell 时的 Host 连接问题。
- 在自己发送的消息之间跳转,并快速回到最新输出,Agent 工作时也可使用;手动滚动会停止自动导航。
- 改进多行文本粘贴和终端布局更新。
- 改进通过常见包管理器安装的 Agent CLI 检测。
0.1.6 12 Sept
What's new in 0.1.15:
• Chat with Claude Code, Codex, Pi, and Oh My Pi in a native conversation view, with readable replies, tool activity, and code changes.
• Send messages and skills from Chat, respond to supported approval and question prompts, and switch to the terminal whenever you need it.
• Keep saved conversations available offline. Collapse completed steps and preview images without losing your place.
• Customize Chat fonts and text size alongside your app and terminal appearance in Settings › Appearance.
• Improved conversation layout, Markdown tables, and Agent switching, with fixes for freezes when navigating between Agents.
0.1.15 新变化:
• 新增原生 Chat,支持 Claude Code、Codex、Pi 和 Oh My Pi,清晰查看回复、工具执行过程和代码改动。
• 在 Chat 中发送消息和技能,处理支持的授权与提问,随时切换到终端。
• 离线查看已保存的对话,折叠已完成的步骤,并预览对话中的图片。
• 在「设置 › 外观」中统一调整 Chat 字体、文字大小,以及应用和终端外观。
• 改善对话排版、Markdown 表格和 Agent 切换体验,修复切换与返回时可能出现的卡顿。
more Version 0.1.15 1 hr ago
Data Not Collected The developer does not collect any data from this app.