你是否试过同时开着 Claude Code、GitHub Copilot CLI、Gemini Terminal 和本地 OpenCode,却在 4 个不同窗口间疯狂切换、复制粘贴、反复 SSH 登录?herdrm 是首个专为 macOS 打造的原生桌面客户端,它不模拟聊天界面,而是直接接管 herdr 运行时管理的所有 AI 编程代理(agents)——无论它们运行在你的 MacBook、公司 Mac Mini,还是远在 AWS 的 Linux 服务器、Tailscale 内网树莓派,甚至 Docker 容器里。它把分散的「AI 编程终端」变成一个统一、可搜索、带状态感知的实时工作台。
核心功能
- 跨设备统一视图,SSH 连接永不“失联”:自动通过
ssh -L转发远程 herdr 服务端口,并内置智能重连机制(1 秒 → 30 秒指数退避),支持 OpenSSH 密钥、Tailscale SSH(v1.98.0+)和 Keychain 安全密码存储——再也不用手动敲ssh -L 8080:localhost:8080 user@prod-server,断网后自动恢复连接,失败原因清晰可见(比如 “AllowStreamLocalForwarding未启用”)。 - 按优先级排序的实时状态面板:左侧边栏不是静态列表,而是动态反映每个 AI 代理的真实运行状态——被阻塞(如等待用户输入)、已完成、正在执行、空闲,按紧急程度降序排列;点击即可跳转,避免在几十个无响应的终端标签页中盲目翻找。
- 真正的原生终端体验,非网页聊天壳:直接调用
herdr agent attach绑定进程 PTY,支持 macOS 原生文本拖选(无需按 Shift)、右键菜单(复制/粘贴/全选/链接跳转)、Cmd+Click 打开 URL;字体渲染精细可控(支持细描边、字重调节、行距微调),暗色/亮色模式下色彩保真度高,不会在 Light 模式下“洗白”。 - 文件与图片直粘直传,跨设备零配置:在 Claude 或 Codex 终端中 Cmd+V 粘贴本地图片或代码文件,herdrm 自动将其上传至本地缓存;若目标代理运行在远程服务器,则通过 SSH 流式传输到远程临时目录(7 天自动清理 + 50MB 总容量限制),开发者无需手动 scp 或 base64 编码。
- 全局 ⌘K 快速唤起,跨设备秒级定位:按下 Cmd+K,弹出搜索框,输入 “gemini”、“prod-db” 或 “setup.sh”,即可从所有已连接设备(本地 + N 台远程)中即时筛选出匹配的 Agent 或 Space,回车直达——告别打开 Finder → 查找终端应用 → 切换窗口 → 输入命令的冗长路径。
- 系统级通知联动,关键时刻不漏响应:当某个 AI 代理主动请求人工介入(例如卡在权限确认、需要审核生成的 SQL),herdrm 立即触发 macOS 原生通知横幅;点击通知,自动聚焦对应终端并滚动到最新行,真正实现“人在哪,上下文就在哪”。
- 空间(Space)级管理,支持 SSH 上的目录浏览:新建 Space 不仅创建隔离环境,还内建目录选择器——即使目标服务器是远程的,也能图形化浏览其文件系统(基于 herdr 的安全目录 API),选中路径后自动启动新 Agent,无需记忆
cd /srv/app。
技术亮点
- Swift + AppKit 原生架构,非 Electron/Webview 套壳:全程使用 Swift 编写,深度集成 macOS 系统能力(Keychain 访问、通知中心、NSPasteboard 图片处理、Terminal 渲染优化),内存占用低、响应快、无 Web 渲染延迟,真正发挥 Apple Silicon 芯片性能。
- 多层连接抽象与故障诊断闭环:SSH 连接层封装了 OpenSSH 配置解析(支持
~/.ssh/config别名)、Tailscale SSH 自动发现、密钥代理协商;网络异常时不仅显示 “Disconnected”,更精准提示底层原因(如 “SSH port forwarding refused by server” 或 “herdr daemon not running on remote”),大幅降低调试门槛。 - PTY 直通 + 智能会话韧性设计:绕过任何中间协议桥接,直接复用 herdr 的标准 PTY attach 接口;当 SSH 连接中断或远程 herdr 升级导致协议不兼容时,界面显示醒目的 “Reconnect” 按钮而非卡死黑屏,且支持混合版本 herdr 二进制共存,保障生产环境稳定性。
- 跨设备状态同步的轻量协议:本地 herdrm 客户端与远程 herdr 服务端通过精简 JSON-RPC over HTTP 通信,仅同步必要元数据(Agent 状态、Space 列表、终端尺寸),不传输完整日志流,降低带宽压力,尤其适合蜂窝网络下的移动办公。
适合哪些人用
主要面向多环境协作的中高级开发者、DevOps 工程师、AI 原生应用探索者:他们通常同时维护本地开发机、测试服务器、云上生产环境,并频繁使用多个 AI 编程代理完成代码生成、SQL 审查、日志分析等任务。
真实场景案例:
- 全栈工程师日常:早上在 MacBook 上用 Claude Code 审查 PR;中午通过 Tailscale 连入公司内网的 Mac Mini,用 Gemini 生成数据库迁移脚本;下午在 AWS EC2 实例上运行 OpenCode 调试 Python 微服务——所有终端统一收口于 herdrm,Cmd+K 搜索 “migrate” 即刻定位三处相关会话。
- 运维自动化提效:将 herdr 部署在 5 台监控服务器上,每台运行定制 Grok Agent 分析 Zabbix 日志;herdrm 边栏实时显示各节点负载状态,某台服务器告警时,通知直达并自动聚焦其终端,运维人员 3 秒内即可查看原始日志流并执行干预命令。
快速上手
安装只需两步:
- 安装 herdr 运行时(所有目标设备均需):
curl -fsSL https://herdr.dev/install.sh | sh(支持 macOS/Linux) - 下载 herdrm macOS 应用:
访问 GitHub Releases 页面,下载最新.dmg文件,拖入 Applications 文件夹。首次启动会引导添加 SSH 主机(支持user@host、ssh://user@host:2222或myserver别名)。
启动后,底部状态栏显示所有已连接设备(含 OS 徽章),左侧边栏即刻列出本地及远程的 Spaces 与 Agents。按 ⌘N 新建代理,⇧⌘N 新建 Space,⌘K 全局搜索——无需额外配置,开箱即用。
同类对比 / 注意事项
- vs VS Code 插件或网页控制台:herdrm 不依赖编辑器宿主环境,不共享 VS Code 的扩展沙箱或浏览器的安全策略,可独立运行、后台常驻,且终端保真度远超 Web-based TTY(如 xterm.js);但目前暂不支持 Windows/Linux 客户端(官方明确标注 macOS-only)。
- vs tmux/screen 多路复用器:tmux 解决的是单机多会话管理,而 herdrm 解决的是「跨异构设备的 AI 代理生命周期协同」,本质是运行时(herdr)+ 控制面(herdrm)的垂直整合方案,非通用终端复用工具。
- 注意事项:首次连接远程主机需确保其
sshd_config启用AllowStreamLocalForwarding yes;若使用密码认证,密码由 macOS Keychain 加密存储,不可导出;当前不支持自定义 herdr 服务端口(固定 8080),需在远程主机调整 herdr 启动参数。
项目信息
missuo/herdrm
GitHub
Native macOS console for herdr — all your coding agents and their live terminals, across devices
623
Stars
39
Forks
Swift
—
编程语言:Swift|Star 数:623|开源协议:未在 README 明确声明(建议查阅 LICENSE 文件)|GitHub 项目地址
如果你厌倦了在 Terminal、iTerm、VS Code、浏览器之间疲于奔命地切换 AI 编程环境,herdrm 就是那个帮你把「AI 编程工作流」真正收束为 macOS 原生体验的关键拼图——它不制造新范式,而是让已有的强大工具链,第一次拥有了统一、可靠、有呼吸感的操作中枢。




