Harness Remote
从桌面、网页或 Android 远程管理现有编码代理会话，并在机器与代理之间接续工作。
- Star 数
- ★ 423
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- JavaScript
- FA 评分
- 69/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 开发者在家用电脑启动 Codex CLI 会话，之后用 Android 查看进展并继续工作。
- 不适合
- 必须把网关直接暴露到公网的团队
- 希望由该工具限制编码代理操作权限的团队
- 源码审查
- 69/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Harness Remote 是围绕现有编码代理运行的本地优先控制平面，不会取代代理或创建统一的合成对话。它通过一个 Machine gateway 发现并呈现机器上的 Projects 和原生 Sessions，可连接 Codex CLI、Claude Code、GitHub Copilot CLI、OpenCode、MiMo Code、Oh My Pi 和 PI。用户可在桌面、网页或 Android 客户端查看活动、发送提示、停止轮次，并处理代理所支持的问题和权限请求。继续任务时，它会在目标代理上创建真正的原生 Session，并记录与源 Session 的关联；也支持在配置好的机器间延续工作。代码、凭据、订阅和原生 Session 持久化留在运行代理的机器上，远程访问应通过可信局域网或 VPN。
在目标机器上安装并验证至少一个受支持的编码代理 CLI 后，运行 npx harness-remote 启动一个 Machine gateway；它会自动检测已安装的代理、选择可用端口并生成凭据。Harness Remote 将机器组织为 Machines → Projects → 原生 Sessions，客户端可以查看会话活动、发送提示、停止轮次，并展示代理支持的问题或权限请求。Codex 会把运行中收到的提示纳入当前轮次；其他文档所列 harness 会将提示排入队列，等待用户撤回或后续处理。跨代理或跨机器接续会在目标 harness 创建原生 Session，并记录会话关系；可传递目标、决策、未解决事项和已运行检查等有限上下文。代理继续负责对话语义、工具执行、模型行为和恢复语义。
- 开发者在家用电脑启动 Codex CLI 会话，之后用 Android 查看进展并继续工作。
- 团队成员需要通过可信局域网或 VPN 查看另一台开发机上的原生编码代理会话。
- 使用 OpenCode 的开发者想把任务交给 Codex 或 Claude Code，并保留源会话与新会话的关联。
- 开发者从普通 CLI 启动会话，稍后通过桌面或网页客户端找到同一个原生 Session。
- 需要在多台已配置机器间继续项目工作的用户，希望保留 Project 身份和会话沿袭关系。
如何安装或部署这个 Agent？
桌面用户可从 GitHub 最新版本下载并打开 Harness Remote；Windows 和 macOS 桌面应用会自动启动并管理本机 Machine runtime。要添加另一台机器，安装 Node.js 20+，并确保至少一个受支持的编码代理 CLI 已安装且完成身份验证，然后运行：
npx harness-remote也可从 GitHub 直接运行：
npx --yes github:giuliastro/harness-remote如果通过托管网页客户端连接网关，需把网页来源加入 CORS：
npx harness-remote --cors https://giuliastro.github.ioAndroid 通过扫描网关或应用中生成的短时配对二维码连接。README 未说明软件或编码代理 CLI 的定价。
如何使用这个 Agent？
在要控制的机器上保持 gateway 终端运行。可选地限定 Project 目录、指定端口或允许的网页来源：
npx harness-remote --root ~/dev
npx harness-remote --port 4900
npx harness-remote --cors https://giuliastro.github.io在客户端打开 Machines，选择机器和 Project，再进入原生 Session。Android 用户选择 Scan machine QR code 并扫描 gateway 打印的二维码；也可在桌面或网页客户端的 Machines 页面选择 Pair a phone 生成二维码。远程网关应只通过可信局域网或 VPN 使用，切勿直接暴露到公网。--root 只限制 Project 选择范围，不是操作系统沙箱。
这个 Agent 有哪些优点和局限？
- 保留 Codex、Claude Code 等工具自己的原生 Session、上下文、权限和恢复语义。
- 支持在代理之间以及已配置机器之间继续任务，并记录 Session 关系。
- 提供桌面、网页和 Android 访问；Windows 和 macOS 桌面应用会自动管理本机 runtime。
- 通过运行中的 harness 发现模型和能力，避免把控制项硬编码为所有代理通用功能。
- 需要 Node.js 20+ 以及至少一个已安装并完成身份验证的支持代理 CLI。
- 网关必须保持运行；停止或重启网关会中断正在进行的轮次。
- 项目明确要求通过可信局域网或 VPN 访问，不应将网关直接暴露到公网。
--root不是安全沙箱，代理仍以启动它的账户权限运行。- 代理的 transcript、工具执行、模型行为和恢复语义仍由各自 harness 决定。
这个 Agent 与同类方案有什么区别？
与直接使用单个编码代理 CLI 相比，Harness Remote 在其外层增加机器、项目和会话发现、远程控制以及跨代理或跨机器接续；实际执行、上下文和原生 Session 仍由所选代理掌管。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Harness Remote 当前 | 69 · 存在缺口 | 桌面应用 | ★ 423 | 今天 | JavaScript | Codex · Claude Code |
| Portable Handoff | 84 · 表现良好 | 命令行工具免费 | ★ 22 | 1 个月前 | Python | Codex · Claude Code |
| Happier | 82 · 表现良好 | 桌面应用免费 + 模型费 | ★ 2k | 今天 | TypeScript | Codex · Claude Code |
| Caprock | 62 · 存在缺口 | 桌面应用免费版 + 付费版 | ★ 25 | 今天 | Go | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README说明代码、凭据和原生 Session 留在用户机器上，建议仅经可信 LAN/VPN 使用，并明确 --root 不是操作系统沙箱；测试显示默认拒绝未获授权的工具许可、可选择一次性许可，桌面开启手机配对需确认。扣分原因：代理仍以启动账户权限运行，网关可远程发送提示与控制，依赖安全审查材料有限，未见明确回滚机制；发布者身份未知且仓库材料未清楚说明维护责任人。
ACP 客户端测试覆盖初始化、并发启动、分页、超时、进程退出、EPIPE 和可操作的错误详情，README也说明网关重启会中断进行中的回合。扣分原因：测试文件不能证明执行结果，包仅列出少量直接依赖，缺少依赖可用性或故障恢复的完整静态证据。
README清楚列出桌面、Web/PWA、Android、多台机器及多种原生代理的使用场景；能力矩阵、原生 Session 所有权边界和目标环境要求也有指引。扣分原因：启动触发与适用条件分布在多份文档，且各代理所需环境的覆盖不完全可从提供材料确认。
README将快速开始、功能、安全、开发和参考文档分区，提供 Node.js 20+ 安装步骤、命令示例，版本为 3.5.0，Apache-2.0 许可证文本完整。扣分原因：本材料没有变更日志内容，常见问题覆盖有限，且维护负责人和更新责任未明确；安装说明对不同系统和代理的细节不均。
产品围绕远程观察、恢复原生 Session 及跨代理/跨机器延续工作，输出包括可检查的交接上下文、Session 状态和诊断信息，明确保留原代理语义。扣分原因：用户需部署并维护本地网关，且多机、手机配对等功能会增加配置成本；提供材料无法量化节省或可靠性收益。
主要产品边界和安装主张可在 README、package.json、许可证、工作流及 ACP 测试之间对照；测试展示了特定客户端行为和错误处理。扣分原因：不少功能描述仍是 README 的主张，未提供实现源码或完整文档来逐项核实；静态证据不能验证运行表现，信心因此为低。
- 不要将网关直接暴露到公共互联网；README明确建议仅通过可信 LAN 或 VPN 使用。
- --root 只限制项目选择范围，不是沙箱；代理继承启动账户权限。
常见问题
使用 Harness Remote 是否需要付费？
它会把我的代码或凭据传到 Harness Remote 云端吗？
网关停止或断线时会发生什么？
它能限制编码代理访问哪些文件吗？
--root 会限制 Harness Remote 提供哪些目录供 Project 选择，但不是操作系统沙箱；代理仍拥有启动它的账户权限。