最近做了一个叫 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
项目地址
https://github.com/wangweijia/TermRelay
欢迎试用，也想听听大家对下面几个方向的看法：
- 是否需要提供 Docker 一键部署
- 更倾向自托管，还是由服务端托管
- 还希望支持哪些 Agent CLI
- 手机端最需要哪些远程操作能力
目前主要精力仍放在稳定性、协议兼容和审批安全上。遇到问题可以直接提 Issue 。
Select Language