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
日增长
+58
周增长
895
stars
99
forks
0
watchers
342
prs
388
issues
26
releases
README
Heeler herdr(agent 优先的终端运行时)与 tmux 的原生 iOS 伴侣应用。 English | 简体中文 | 繁體中文 | 日本語 --- Heeler 是 iPhone 和 iPad 上独立的 herdr 移动客户端和 Agent 控制台,用于远程操作 Claude Code、Codex 和其他编程 Agent。Agent 在你自己的 Host 上通过 Herdr TUI、Herdr 桌面端(herdr-core)或 tmux 运行,Heeler 通过 SSH 连接。跨机器查看多个 Agent,按「谁需要你」排序,再打开实时终端或支持的 Chat 对话发送指令。 截图 | Agent Console | 实时终端 | Chat | | --- | --- | --- | | | | | | Keyboard | Changes | Terminals | | --- | --- | --- | | | | | | Skills | Hosts | 实时活动 | | --- | --- | --- | | | | | | Usage | 小组件 | 锁屏小组件 | | --- | --- | --- | | | | | 查看 iPad 截图 功能 - Console —— 所有机器上的 Agent 汇成一个按状态排序的列表(Blocked 排最前),可按 Host 过滤,实时更新。 - Herdr 桌面端与 herdr-core —— 连接 macOS、Linux 与 Windows 原生环境上的 Herdr 桌面端或无界面 herdr-core。Console 跟随桌面端的空间与标签页,实时终端、 Chat、Composer、New Agent 和 New Workspace 同样可用 (了解更多)。 - tmux —— 连接 macOS 或 Linux 上的 tmux 3.3+ 服务器。会话、窗口与窗格直接 呈现在 Console 中,实时终端会调整为适合屏幕的尺寸并保持在同一窗口已打开的 桌面终端范围内,Chat、Composer、New Agent、New Workspace 和 Worktrees 同样可用,配合 Claude Code 钩子与可选的 Host Helper 提供 Agent 状态、 通知、实时活动与 Usage(了解更多)。 - Attach —— libghostty 渲染的 Agent 真实终端:原生历史回看、也能驱动全屏 TUI 的惯性触摸滚动、长按选择、接管失效的终端占用者,并静默收集网页链接 供稍后打开。 - Chat —— 以原生消息而不是终端画面阅读 Agent 的对话,在 Composer 里 回复,并用按钮回答 Blocked 的 Agent;支持 Claude Code、Codex、Pi、 Oh My Pi、Grok Build、OpenCode 和 Antigravity CLI(了解更多)。 - Composer —— 在本地用完整的 iOS 键盘起草(自动纠错、输入法、听写), 一次 Send 投递;工具键盘另有 Agent 控制键、Agent Skills、可复用的 Snippets 和终端外观。 - Terminal —— 在 Agent 的目录打开普通 shell,带 Text / Keys 两种模式, 每个工作区复用同一个 tab。 - 附件 —— 把照片或最大 64 MiB 的文件经 SFTP 暂存到 Host,并把路径 插入草稿。 - 扫码配对 —— 扫描 Pairing Code 即可添加机器;密钥在设备上生成,私钥 不离开 Keychain,配对码同时固定 host key 指纹。 - 通知 + 实时活动 —— Agent 进入 Blocked 或 Done 时的端到端加密推送, 以及锁屏 / 灵动岛上实时跟踪 Agent 的横幅;中继永远读不到内容 (PRIVACY.md)。 - Usage —— Claude Code 与 Codex 的 Usage Limits 及重置时间,以及最多 30 天的 Token Usage 和估算 API 费用,可汇总所有 Host 或只看一台;主屏和 锁屏小组件随时可见(了解更多)。 - Worktrees —— 让 Agent 从工作区仓库的干净检出上启动。 - 外观 —— 跟随系统 / 浅色 / 深色;30 个主题,浅色深色各有独立槽位, 终端、Chat 和整个 App 都使用它;内置 JetBrains Mono 与 IBM Plex Mono; 双指缩放字号。 - 跳板机 —— 经 SSH 跳板访问不可直连的机器,两跳各自校验密钥。 连接原理 在 macOS 和 Linux Host 上,Heeler 通过 SSH 使用 herdr 的 JSON API:每个请求经 direct-streamlocal 通道直连 herdr.sock,一条长连接承载事件流,交互终端则在 SSH PTY 上运行 herdr agent attach --takeover。前提只有 SSH 访问和一个运行中的 herdr —— 不改服务器、不装额外软件包。SSH 服务器需允许 stream-local 转发 (OpenSSH 默认开启);若被关闭,引导流程会明确指出。 Windows 原生 Host(herdr = 0.9.3)通过 SSH 连接,需手动添加。 herdr-core Host(包括运行 Herdr 桌面端的机器)需手动添加,并确认 Server Kind。Heeler 与 core 之间只有一条分帧链路:macOS 和 Linux 上经 direct-streamlocal 通道直连 core 的套接字,Windows 原生环境上经 SSH exec 运行 herdr-core connect。在 macOS 和 Linux 上,连接本身绝不会启动 core。可选的 Host Helper 在 macOS 和 Linux 上提供通知、实时活动和 Usage(连接 herdr-core)。 tmux Host(macOS 与 Linux 上的 tmux = 3.3)同样需手动添加,并确认 Server Kind 与套接字名称。连接本身绝不会启动 tmux 服务器;在 Linux 上可按需通过 New Workspace 启动。实时终端通过 tmux 控制模式与桌面客户端并存接入,调整为适合屏幕的尺寸并保持在同一窗口已打开的桌面终端范围内。Claude Code 钩子可上报 Blocked、Done 与会话 ID,可选的 Host Helper 提供状态读取、Pi 与 Oh My Pi 扩展、通知、实时活动和 Usage(连接 tmux)。 如需通过 Tailscale、ZeroTier 或 EasyTier 访问机器,请参阅 Overlay Network 设置教程。教程
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":