Roamgate

为 Herdr 提供浏览器客户端,在桌面或手机上操控终端、查看编码代理会话并评审文件与 diff。

Star 数
★ 293
最近更新
今天
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具网页应用自托管服务
可在哪里用
平台专用
费用
免费,无需付费服务
上手难度
中 · 需要几步配置
开始前需要
Herdr 服务器Bun 1.4.3 或更新版本(用于开发)Shell / 命令行网络访问本地文件系统
典型场景
在家或通勤路上用手机打开 Roamgate,查看编码代理刚提交的 diff 并留下行级评审意见。
不适合
  • 不想运行 Herdr 服务端的用户
  • 希望纯离线使用、不依赖任何服务进程的人
  • 需要多人协作或多租户托管的团队

这个 Agent 能做什么,适合哪些场景?

Roamgate 是 Herdr 的浏览器客户端,把终端控制、代理会话观察和代码评审搬进浏览器,桌面和手机都能用。它本身不承担代理运行时,而是连接一个正在运行的 Herdr 服务器,由后者提供终端与工作区能力,因此必须先安装并启动 Herdr。安装后你会得到一个本地 Web 地址,打开即可使用,也可以作为 PWA 安装到桌面或手机主屏,获得没有地址栏的独立窗口。它面向的是「离开工位也想盯一眼编码代理」的开发者:看文件树、读 diff、在具体行上留评论、跑测试、预览静态 HTML 都能完成。项目用 MIT 许可发布,Linux/macOS 通过安装脚本、Windows 通过发布压缩包分发,开发环境要求 Bun 1.4.3 或更新版本。因为能改真实文件和操作终端,默认运行时也强制要求 token 或密码,官方建议保持回环绑定。

Roamgate 连接 Herdr 服务器后,在浏览器里提供几类具体操作:终端控制(含移动端 Composer 与终端快捷键)、文件浏览器(可打开工作区文件并预览静态 HTML)、diff 评审(在具体行上留下行评论与评审反馈)、查看编码代理会话,以及运行测试并看到结果。仓库还包含一个实验性的 Ranger 工作区管理助手,可以查看工作区上下文、执行受支持的操作并安排后台检查,它要求 Herdr 与 Roamgate bridge 同时运行。安装侧提供 roamgate 命令行工具,其中 roamgate herdr setup 可以代为安装并启动 Herdr;bun run dev:server 和 bun run dev:web 分别启动开发用服务端与前端,默认访问 http://localhost:5173。输出是网页界面与其中的文件、diff、终端会话,不产生持久化的代理产物。部署边界明确:它需要常驻可访问的进程,PWA 模式并不等于离线访问。

  1. 在家或通勤路上用手机打开 Roamgate,查看编码代理刚提交的 diff 并留下行级评审意见。
  2. 把 iPad 作为第二屏,一边在桌面写代码,一边用 Safari 添加到主屏的 PWA 窗口盯测试输出。
  3. 在只有浏览器的受限环境里,通过自托管实例控制自己的工作区终端,而不安装本地客户端。
  4. 让代理跑完测试后,用文件浏览器打开工作区里的静态 HTML 预览,确认页面结果。
  5. 使用 Ranger 助手查看工作区上下文、执行受支持操作并安排后台检查。
  6. 从 Herdr Studio / herdr-gui 迁移过来的用户,按迁移指南手动安装 Roamgate 继续用。

如何安装或部署这个 Agent?

先安装并启动 Herdr,也可以稍后让 Roamgate 代劳。

Linux / macOS:

curl -fsSL \
  https://github.com/powerfooI/roamgate/releases/latest/download/install-roamgate.sh \
  | ROAMGATE_VERSION= sh

Windows 请到 latest release 下载对应的 x64 或 ARM64 压缩包,解压后运行 roamgate.exe。

Linux/macOS 还需要把 ~/.local/bin 加入 PATH:

roamgate herdr setup

安装包校验、配置、更新与服务化参见 docs/DEPLOYMENT.md;如果还在用 herdr-gui 0.6.2,同一文档里有历史安装说明。

如何使用这个 Agent?

启动服务并打开它打印出的地址:

roamgate

首次访问需要 token 或密码认证(包括回环访问)。想当日常应用用的,可以在认证后安装为 PWA:iPhone/iPad Safari 用「分享 → 添加到主屏幕」,macOS Safari 17+ 用「文件 → 添加到 Dock」,Chrome/Edge 用浏览器菜单里的「安装应用」。

从源码开发需要 Bun 1.4.3 或更新版本,以及一个正在运行的 Herdr 服务器:

bun install --frozen-lockfile

然后分别在两个终端里启动:

bun run dev:server
bun run dev:web

浏览器打开 http://localhost:5173 即可。

这个 Agent 有哪些优点和局限?

优点
  • 浏览器即客户端,桌面和手机共用同一套界面,移动端还专门提供了 Composer 与终端快捷键。
  • 覆盖完整评审闭环:文件树、diff 行评论、评审反馈、跑测试和静态 HTML 预览在同一个界面里完成。
  • 可以安装为 PWA,获得无地址栏的独立应用窗口,日常使用体验接近原生客户端。
  • MIT 许可,Linux/macOS/Windows 都有安装路径,并提供 roamgate herdr setup 帮你装好前置的 Herdr。
  • 默认强制 token 或密码认证并建议保持回环绑定,对能改真实文件和操作终端这类高风险能力有明确约束。
局限
  • 强依赖正在运行的 Herdr 服务器,没有 Herdr 就完全无法使用。
  • 进程必须常驻且可访问,官方明确说明 PWA 模式不是离线访问。
  • Ranger 助手标注为实验性功能,还额外要求 Roamgate bridge 同时运行。
  • 从 Herdr Studio / herdr-gui 迁移不提供自动升级,必须按迁移指南手动安装。
  • 开发环境要求 Bun 1.4.3 或更新版本,并需要同时跑 dev:server 与 dev:web 两个进程。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Roamgate 当前 55 · 缺口较多 命令行工具免费 ★ 293 今天 TypeScript —
Aster 77 · 表现良好 命令行工具免费 + 模型费 ★ 122 4 天前 Rust OpenAI API
Kandev 74 · 存在缺口 命令行工具免费 + 模型费 ★ 945 今天 Go Codex · Claude Code
vibepanel 多代理开发控制台 85 · 表现良好 自托管服务免费 + 模型费 ★ 54 今天 Go Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
55/ 100 五分制 2.8 / 5
信任安全 17/29
可靠稳定 8/14
适用触发 10/18
规范维护 10/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全17 / 29 · 2.9/5

SECURITY.md 对信任模型、默认 127.0.0.1 绑定、登录强制、令牌/密码/PIN 的强度与限流、cookie 签名密钥轮换、Web Push 端点限制等有非常具体的说明,敏感数据与凭据处理(sensitive_data_handling)达到 3:明确要求 15-1024 字符密码、256 位随机令牌、独立签名密钥、owner-only 权限、凭据变更即轮换签名密钥。least_privilege 给 2:默认回环绑定与登录强制是好的最小暴露实践,但文档明确承认“UI 访问即授予用户全部权限”,没有多用户权限或沙箱,属于特权管理而非最小权限。data_flow_transparency 给 2:说明了令牌文件路径、会话 cookie、推送注册表、更新来源等数据流向,但缺少对终端/文件内容具体传输路径的完整描述。user_confirmation 仅 1:文档提到更新请求需要认证头、推送变更需要认证头,但没有描述破坏性操作(删除工作区、修改真实文件)前的确认流程。dependency_security 给 2:package.json 有 overrides 固定 highlight.js 与 undici,CI 有 bun audit --audit-level=high 脚本,但审计未接入 CI 工作流,且未提供锁文件内容或漏洞状态证据。external_effects 仅 1:README 明确“控制终端并修改真实文件”,但未说明外部副作用的边界、审计日志或影响范围控制。rollback 仅 1:提到更新校验和、凭据轮换、会话重置,但没有针对文件修改或终端操作的撤销/回滚机制。source_attribution 给 2:LICENSE 署名 Arthur,package.json 有 author/homepage/repository,THIRD_PARTY_NOTICES 提及第三方资产,但发布者身份未经验证,且仓库名 powerfooI 与作者署名不一致,扣分于此。

可靠稳定8 / 14 · 2.9/5

self_consistency 给 2:README、SECURITY.md、package.json 在版本 0.8.3、Bun 1.4.3、MIT 许可、Herdr 依赖上相互一致,但 README 描述为“Herdr 客户端”,package.json 描述为“独立社区 Web 与 PWA 客户端”,措辞略有出入。dependency_availability 给 2:engines 明确 bun>=1.4.3,packageManager 固定 [email protected],CI 使用 --frozen-lockfile,依赖可获取性有保障;但未提供锁文件内容,无法核实全部依赖可用性。failure_messages 仅 1:SECURITY.md 提到 429/413 状态码与 Retry-After,但这是安全文档而非产品错误信息设计;仓库未展示面向用户的失败提示、诊断输出或错误分类,证据不足。

适用触发10 / 18 · 2.8/5

audience_and_scenarios 给 2:README 明确面向桌面与移动用户、PWA 日常使用、远程访问场景,并给出截图与教程链接,受众清晰。capability_boundaries 给 2:明确“需要运行中的 Herdr 服务器”“PWA 非离线访问”“Ranger 为实验性”“不支持自动升级”,边界有说明;但未系统列出不支持的操作或权限上限。trigger_precision 仅 1:作为客户端产品,触发条件(何时连接、何时需要认证、何时进入开发模式)散落在文档中,缺少统一的触发/前置条件清单。environment_fit 给 2:覆盖 Linux/macOS/Windows、x64/ARM64、Bun 版本、PWA 安装方式,环境适配说明较全,但未提供各环境的验证证据。

规范维护10 / 18 · 2.8/5

information_architecture 给 2:README 结构清晰(截图、快速开始、PWA、文档、开发、安全、许可),并链接 FEATURES/DEPLOYMENT/ARCHITECTURE/SECURITY/CONTRIBUTING,但部分链接文件未在证据中提供。install_notes 给 2:给出 Linux/macOS 安装脚本、Windows 归档、PATH 配置、校验和指引,安装说明较完整;但安装脚本本身未在证据中,无法核实。naming_stability 仅 1:存在 HERDR_GUI_* 到 ROAMGATE_* 的别名迁移、herdr-gui 到 roamgate 的重命名、历史安装路径,命名稳定性存在明显历史包袱。examples_and_faq 仅 1:有截图与教程链接,但没有 FAQ、常见错误示例或配置示例代码。known_limitations 给 2:明确列出不支持自动升级、PWA 非离线、PIN 较弱、开发模式绕过认证、不信任转发 IP 等限制,说明较充分。license 给 3:LICENSE 为完整 MIT 文本,package.json 声明 MIT,README 说明代码 MIT 与第三方资产条款,许可处理完整。versioning_changelog 仅 1:package.json 有版本 0.8.3,但无 CHANGELOG 文件,版本历史与变更记录缺失。maintenance_responsibility 仅 1:有 SECURITY.md 漏洞报告流程与 CONTRIBUTING 链接,但发布者未经验证,维护责任主体不明确,扣分于此。

有效结果7 / 13 · 2.7/5

output_usability 给 2:产品输出为浏览器/PWA 界面,截图显示文件浏览、diff 注释、终端、HTML 预览等可用输出,面向实际使用场景。marginal_value 给 2:作为 Herdr 的 Web/PWA 客户端,提供移动端访问与远程审查能力,相对纯桌面客户端有增量价值,但依赖 Herdr 生态,独立价值有限。cost_benefit 仅 1:需要运行 Herdr 服务器、Bun 1.4.3、保持进程常驻、配置认证与 TLS,部署与运维成本不低,而收益主要是移动访问便利,成本收益比证据不足。

证据核验3 / 8 · 1.9/5

claim_traceability 仅 1:README 与 SECURITY.md 的声明多为文字描述,缺少指向具体代码、测试或配置的引用,无法逐条追溯。cross_source_corroboration 仅 1:README、SECURITY.md、package.json、CI 工作流之间在版本、许可、Bun 版本上部分互证,但安全声明与代码实现之间无交叉证据。fact_inference_separation 仅 1:文档混合了事实陈述与设计意图(如“正常运行时需要登录”),未明确区分已验证事实与设计目标,静态审查下难以分离。

风险与缓解建议
  • 发布者身份未经验证,仓库所有者 powerfooI 与 LICENSE 署名 Arthur 不一致,无法确认维护主体与更新路径。
  • SECURITY.md 明确承认 UI 访问即授予用户全部权限,没有多用户权限系统或沙箱;不要将其视为隔离环境。
  • 开发模式(NODE_ENV=development 且绑定回环地址)会绕过认证,包括经反向代理或隧道访问;切勿将开发监听器暴露给远程。
  • 产品会控制终端并修改真实文件,但文档未描述破坏性操作的确认流程或回滚机制。
  • 依赖审计脚本存在但未接入 CI,且未提供锁文件内容,无法核实依赖漏洞状态。
  • 缺少 CHANGELOG,版本历史与变更记录不可追溯。
  • 本次为静态源码审查,未执行任何代码或测试,所有结论置信度为低。
证据充分度:低 评估于 2026年10月13日 审查版本 fd7acf3c7638
查看完整评分方法 →

常见问题

Roamgate 需要花钱吗?
代码以 MIT 许可发布,仓库中没有提及任何付费版本或付费服务;你需要自己准备一台能跑 Herdr 与 Roamgate 的机器。注意打包的字体和品牌素材保留各自原始条款,见 THIRD_PARTY_NOTICES.md。
不装 Herdr 能直接用吗?
不能。README 明确写着「Requires a running Herdr server」。你可以先手动安装并启动 Herdr,也可以安装 Roamgate 之后用 roamgate herdr setup 让它代为安装和启动。
安装成 PWA 之后断网还能用吗?
不能。README 特意强调「PWA 模式不是离线访问」,进程必须保持运行且可达,PWA 只是省掉浏览器标签页和地址栏。
暴露到局域网或公网安全吗?
Roamgate 会控制终端并修改真实文件,所以正常运行时即使走回环也要求 token 或密码。官方建议保持默认的回环绑定,在允许其它设备访问之前先读 SECURITY.md。
我之前用的 Herdr Studio / herdr-gui 能自动升级过来吗?
不支持自动升级。需要按 docs/DEPLOYMENT.md 的迁移指南手动安装 Roamgate;该文档里也保留了 herdr-gui 0.6.2 的历史安装说明。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents