giuliastro/harness-remote
Native-session control plane for Codex, Claude Code, OpenCode, OMP and PI. Run, resume and hand off coding sessions across your machines.
Harness Remote – 面向 AI 编码代理的本地优先控制平面
它是什么
- 位于现有 AI 编码代理 (Codex CLI、Claude Code、OpenCode、Oh My Pi、PI) 之上的一个轻量“遥控”层。它不替换这些代理；而是发现它们创建的原生会话，并让您可以跨代理和机器观察、暂停、恢复和交接工作。
为什么重要
- AI 编码代理将所有重型上下文 (模型、工具使用、凭据、代码) 保存在您自己的计算机上。Harness Remote 允许您从桌面应用、Web/PWA 或 Android 客户端管理这些会话，而无需将代码或提供商密钥移动到云服务。
主要功能 (如 README 中所述)
| 功能 | 您获得什么 |
|---|---|
| 原生会话保持权威 | 底层代理仍然拥有转录、推理、工具调用和模型行为。Harness Remote 仅添加 UI 和协调层。 |
| 跨代理延续 | 使用一个代理 (例如 OpenCode) 开始任务，然后在保留原始项目身份的同时将其交给另一个代理 (例如 Claude)。 |
| 跨机器延续 | 在不同的计算机上继续同一项目，同时保持原始会话谱系。 |
| 本地优先安全 | 所有源代码、凭据和会话数据都保留在您的机器上；网关可以在 LAN 或 VPN 后面运行，绝不公开暴露。 |
| 发现与能力矩阵 | 在运行时，Harness Remote 会查询正在运行的代理 ("harness") 以了解支持的模型、默认值和权限，而不是硬编码它们。 |
| 多平台客户端 | • 桌面应用 (Windows/macOS、Electron) – 自动启动自己的本地网关。\n• Web/PWA – 托管在 giuliastro.github.io/harness-remote 或本地运行。\n• Android – 从网关扫描二维码进行连接。 |
| 简单安装 | 在您想控制的机器上，安装 Node 20+，确保安装了受支持的编码代理 CLI，然后运行 npx harness-remote (或 GitHub 快捷方式)。 |
| 项目/工作区视图 | 机器 → 项目 → 原生会话，在一个窗格中浏览所有活跃的 AI 编码会话。 |
如何使用
- 启动网关 – 在已安装编码代理 CLI 的计算机上运行 (
npx harness-remote)。网关检测代理、选择端口、生成临时凭据并运行一个小型守护进程。 - 连接客户端 – 将桌面、Web 或 Android 客户端连接到该网关 (通过二维码或手动地址)。客户端显示原生会话列表。
- 观察或控制 – 查看代理输出、发送新提示、停止轮次、回答权限请求，或在不同的代理或机器上创建延续。
- 稍后恢复 – 由于原生会话保留在原始代理中，您可以关闭客户端、关闭网关，稍后重新连接以从上次停止的地方继续。
受支持的代理 (截至 README)
- OpenCode 2 (原生 ACP 后端，仍在验证中)
- OpenCode Legacy (v1) – HTTP + 事件流
- Claude Code – ACP 适配器
- Codex CLI – ACP 适配器
- Oh My Pi – ACP 适配器
- PI – ACP 适配器
安全说明
- 网关应仅在受信任的 LAN/VPN 上可达；不应暴露到公共互联网。
--root限制作为可选项目显示的文件系统区域，但底层代理仍以用户的正常操作系统权限运行。
开发状态
- Apache-2.0 许可的开源软件。
- 仓库包含 Node.js 守护进程、桥接测试、Web 客户端 (Vite) 和 Electron 桌面包装器。提供了运行每个组件的脚本 (
npm start、npm run electron:dev等)。 - 文档包括快速入门、架构路线图、能力矩阵和 OpenCode 的可靠性合同。
底线 Harness Remote 是一个真正的开源工具，为现有 AI 编码代理添加了本地优先、多设备编排层，让开发人员可以将代码和凭据保留在本地，同时获得远程观察和跨代理连续性的便利。
相关
- 项目
- 项目
- 项目
- 项目
- 项目