做了一个通过 Web 远程操作 Mac 终端和 AI 编程 Agent 的工具： TermRelay

50905

最近做了一个叫 TermRelay 的开源工具，用来从手机或其他电脑远程访问 Mac 上的终端和 AI 编程 Agent 。

它由三个部分组成：

- Mac App：管理本地终端、工作目录和 Agent 进程

- Server：负责设备连接、会话同步、认证和事件持久化

- Web：在浏览器里查看并操作远程会话

目前支持：

- 普通 PTY 终端

- Codex ACP

- GitHub Copilot CLI ACP

- DSH ACP

- Agent 流式回复、思考过程和工具调用

- 高风险操作审批

- 多个同时出现的审批请求

- 手机端审批和回复 Agent 问题

- 长会话历史与增量加载

- 局域网连接

- Cloudflare Tunnel + Access 公网访问

- 浏览器配对和可撤销的设备凭证

和普通 Web Terminal 不太一样，TermRelay 会区分两种会话：

- PTY 会话传输终端字节、输入和窗口尺寸。

- ACP 会话传输结构化事件，例如思考过程、命令执行、文件修改、审批请求和用户问题。

因此在手机上不只是看到一块终端画面，还可以直接处理 Agent 发起的审批，并查看结构化执行过程。

项目还在持续开发，目前更适合愿意自己部署、能接受早期版本的用户。公网部署涉及 Server 、数据库和 Cloudflare 配置，不是开箱即用的托管服务。

技术栈

- macOS：Swift 6 、SwiftUI 、SwiftTerm

- Server：NestJS 、Fastify 、TypeORM 、WebSocket

- Web：Vue 3 、Pinia 、Vite 、xterm.js

- 协议：JSON Schema + ACP

项目地址

欢迎试用，也想听听大家对下面几个方向的看法：

- 是否需要提供 Docker 一键部署

- 更倾向自托管，还是由服务端托管

- 还希望支持哪些 Agent CLI

- 手机端最需要哪些远程操作能力

目前主要精力仍放在稳定性、协议兼容和审批安全上。遇到问题可以直接提 Issue 。

主楼