所有电脑,按“要不要你管”排好
需要你、工作中、已完成、空闲,一屏分好。每个 agent 有自己的小头像,Claude Code 还是 Codex,看一眼就认出来;在哪台电脑、跑到第几轮也都写着。
开源 · 自托管 · 全端支持
Herdr Pocket 把 herdr 里跑着的 Claude Code、Codex、Gemini、OpenCode…… 接到 Android、iOS、鸿蒙手机与 Windows / macOS / Linux 桌面端:看状态、读对话、敲终端。小羊助理替你盯着,谁跑完了、谁卡住了,第一时间告诉你。
需要三样东西: 你的服务器手机或电脑客户端装了 herdr 的电脑它由三部分组成
服务端在中间:手机、桌面客户端和每台电脑都只连它,彼此不用在同一个网络里。按 1、2、3 的顺序装好,所有电脑上的 agent 就都出现在你的客户端上。
装在你自己的服务器(Linux)
手机和电脑之间的中转站:转发状态、对话和终端,小羊助理和语音通话也跑在这里。数据只经过你的服务器。
一条命令部署装在Android / iOS / 鸿蒙 HarmonyOS NEXT / Windows / macOS / Linux
看所有 agent 的状态、对话和终端,直接回复、按键,收提醒,和小羊说话。扫一下服务端给的二维码就连上。
下载安装包并连上装在每台跑 herdr 的电脑(macOS、Linux、Windows)
在后台常驻,读取本机 herdr 里的 agent 发给服务端,再把你从手机发来的指令交给它们。
每台电脑一条命令介绍片
herdr 里能跑的,口袋里都能看
你不必一直守在电脑前。agent 跑完、卡住、等你点确认的那一刻,口袋会先知道。看一眼,回一句,再按个回车,事情就继续往下走。
工作原理
在 herdr 里该怎么跑还怎么跑。每台电脑装一次电脑端,它在后台读取本机的 agent,把状态快照发给服务端。
服务端(中转服务)跑在你自己的服务器上:WebSocket 长连接、传输压缩;设备令牌只存哈希,agent 归属由服务端按连接身份改写,电脑不能冒充别人。
手机扫码配对一次,所有电脑上的 agent 就实时出现在列表里。对话和终端走实时流,断线时自动退回轮询补齐。
回一句话、按 Esc、开一个新 agent,或者直接交给小羊去办,指令沿原路送回电脑。电脑之间也能用命令行互相调用;只读模式和设备白名单随时可开。
手机上的四个视角
需要你、工作中、已完成、空闲,一屏分好。每个 agent 有自己的小头像,Claude Code 还是 Codex,看一眼就认出来;在哪台电脑、跑到第几轮也都写着。
工具调用收成卡片,失败的标出来,思考过程淡淡带过。想插一句,就像聊天一样回它。
实时终端画面,打字直达 agent。App 自带紧凑键盘,Esc、Tab、方向键、回车、Ctrl+C 一按即达,系统输入法不会挡住画面;选菜单、打断都不用回到电脑前。
新电脑运行安装命令后会显示二维码,用已连上的手机扫一下、点“允许加入”。二维码就是一个 https 链接,手机相机也能直接打开;邀请码一次性、10 分钟过期,手机也能邀请别的手机。
小羊助理
App 的第一个页面就是小羊。说一句,她直接去做:给 agent 发消息、按键、新建空间,或在任意一台电脑上启动装好的 agent 并交给它任务,再把真实结果告诉你。agent 跑完或卡住时,她会主动来说一声。
“谁在等我?”“哪个跑完了?”“今天花了多少?”小羊会去每台电脑看一眼再回答,花费能按 agent、空间、电脑分开算。
agent 跑完或卡住,小羊会发消息;让她盯着某个 agent,跑完就来叫你。App 关着也会推到通知栏,走的是手机上的常驻连接,不依赖 Google 推送。
“半小时后提醒我看部署”,到点就提醒。出了问题就问她“卡在哪一步”,她会去翻中转服务和各端的日志。
发消息、按键、新建空间、启动任意装好的 agent(Claude Code、Codex、Gemini、Kimi……),小羊直接去做,再照实告诉你结果,比如“发了,它还没回”“它正在忙,已排在输入框里”。想让她先问你,设置里打开就行,默认关闭。
支持 OpenAI Chat、OpenAI Responses (Codex)、Anthropic、Google Gemini 原生与本地 Ollama 五种协议;内置小米 MiMo、DeepSeek、通义千问、Kimi、GLM、OpenRouter 预设,填上密钥即可自动扫描上游模型。
语音通话
实时语音通话,支持 MOSS-Live 与 OpenAI Realtime 双协议,内置端侧声纹识别与通话降噪。边走路边问“谁跑完了”,她会去查,再用声音告诉你。语音经你自己的中转服务转发,密钥只留在服务器上。
六种表情跟着通话状态切换,点一下试试。
细节
家里、公司、云上的电脑各跑各的,手机上合成一张表。谁在线、谁掉线,一目了然。
Esc、Tab、方向键、Ctrl+C 一按即达,系统输入法不再挡住终端。
常驻连接直接收提醒,国产系统放开后台限制即可。
设备令牌只在配对时出现一次,服务器只留 SHA-256,吊销后立刻断线。
二维码是 https 链接,相机一扫就开;邀请码只能用一次、10 分钟过期,失败太多次会锁定。
在一台电脑的终端里查看、指挥另一台电脑的 agent。--read-only 只许看,--allow 只让指定设备动手。
Docker、Cloudflare 或一条安装命令,自己的服务器自己管。
新版本从 GitHub Releases 推到 App 里,点一下就更新。
粉色的界面,半夜看也不刺眼。
WebSocket 开了压缩,终端画面和对话在路上小好几倍。
小羊按 agent、空间、电脑帮你把花费算清楚。
中转服务、电脑和手机的日志都收在你的中转服务上:命令行用 herdr-pocket logs 查,问小羊“卡在哪一步”,或者打开中转服务上的 /admin 网页面板。
默认说了就做;打开“动手前先问我”,她每次动手前先问你。语音通话里不会停下来等。
开始使用
三种方式任选一种。第一次启动会打印一次性的设置二维码或设置码,留给第一台手机。
mkdir herdr-pocket && cd herdr-pocket
curl -fsSLO https://raw.githubusercontent.com/Crosery/herdr-pocket/main/deploy/docker/compose.yml
docker compose up -d
docker compose logs relay | grep "setup code"跑起来以后,日志面板在 https://<你的服务器地址>/admin
用手机相机扫上一步的设置二维码,会打开连接页;装好手机或桌面客户端后点连接,或直接填入配对码,就连上了。
装好电脑端 herdr-pocket,把这台电脑登记到你的服务端,并在后台保持在线。
终端里出现二维码时,用已连上的手机扫一下,点“允许加入”。
curl -fsSL https://raw.githubusercontent.com/Crosery/herdr-pocket/main/scripts/install-host.sh |
bash -s -- --server https://<你的服务器地址>需要 herdr。macOS 和 Linux 上没有 Node.js 22.18 以上版本时,安装脚本会自带一份;Windows 上总是自带一份。都不需要管理员权限。
以后用 herdr-pocket update 更新,herdr-pocket status 查看状态。
常见问题
全部已发布。移动端提供 Android (.apk)、鸿蒙 HarmonyOS NEXT (.hap,DevEco Studio 签名安装) 与 iOS 未签名侧载包 (.ipa,AltStore / SideStore / TrollStore / Xcode 安装);桌面端提供 macOS (arm64 / x64 .dmg)、Windows (x64 -setup.exe / .msi) 与 Linux (x64 .AppImage / .deb),界面与交互全端一致。
herdr 里跑着的都能看:Claude Code、Codex、Gemini、OpenCode、Kimi、Qwen、Cursor Agent、Droid、CodeBuddy、Qoder、omp、pi 等,普通终端程序也可以,认得出的会显示专属头像。电脑上装好的 agent CLI,小羊也能直接帮你启动。
是的,中转服务由你自己部署,数据只经过你的服务器。用 Docker Compose、一键脚本或 Cloudflare Tunnel 都可以。
能。当前版本没有做端到端加密,中转服务能看到明文,所以请部署在你信任的服务器上,并且务必走 HTTPS。设备令牌只存哈希,可以随时吊销。
会,你说了她就去做:发消息、按键、新建空间、启动 agent,做完把真实结果告诉你,比如“发了,它还没回”或“它正在忙,已排在输入框里”。想每次先确认,就在设置里打开“动手前先问我”(默认关闭);语音通话中她不会停下来等确认。只想让手机看、不让它动,见下一条。
文字助理支持 OpenAI Chat、OpenAI Responses、Anthropic、Google Gemini 原生与本地 Ollama 五种协议(内置小米 MiMo、DeepSeek、通义千问、Kimi、GLM、硅基流动、火山方舟、OpenRouter 等预设),可在客户端或 /admin 网页后台一键自动扫描上游模型并排好主备顺序。语音通话支持 MOSS-Live 与 OpenAI Realtime。不配模型时只是没有助理或语音,其余功能照常用。
能。提醒靠手机上的常驻服务连着你的中转服务,不经过 Google 推送。部分国产系统需要在设置里允许它在后台运行。
可以。电脑端用 herdr-pocket run --read-only 只允许查看,或用 --allow 只让指定设备操作这台电脑。
可以,个人和商用都行。Herdr Pocket 以 AGPL-3.0 开源:修改后拿去对外提供服务的,也要公开改动后的源码。
中转服务、电脑和手机的日志都汇总在你的中转服务上。命令行用 herdr-pocket logs 按时间、设备、级别筛选;也可以直接问小羊“卡在哪一步”,或者打开中转服务上的 /admin 网页面板。