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

最近做了一个叫 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 会区分两种会话：

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


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

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

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

技术栈

• macOS：Swift 6 、SwiftUI 、SwiftTerm


• Server：NestJS 、Fastify 、TypeORM 、WebSocket


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


• 协议：JSON Schema + ACP

项目地址

https://github.com/wangweijia/TermRelay

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

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


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


• 还希望支持哪些 Agent CLI


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

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