我做了个 App：在手机上指挥电脑里的 Claude Code / Codex，还能直接看它产出的图表和模拟器画面
英文标题：我做了个 App：在手机上指挥电脑里的 Claude Code / Codex，还能直接看它产出的图表和模拟器画面
开源 App AgentDeck：在手机上启动、审批电脑里的 Claude Code、Codex 等 agent，直接看它产出的图表和模拟器实时画面。端到端加密，内置免费 agent。
3.2 KB
589 B
20.2 KB
25.4 KB
31.4 KB
37.7 KB
中文
起因
我经常让 coding agent 跑一个比较长的任务，然后去干别的。回来一看，它五分钟前就卡在一个权限确认上，什么也没干。
市面上已经有不少「手机遥控 agent」的工具了，但用下来总觉得是把终端搬到手机上：一屏的文字和日志，在手机上很难看。于是我做了 AgentDeck ，想解决两件事：
- 离开电脑也能开会话、审批权限、收到完成通知；
- agent 的产出在手机上要好看、能直接看 ，而不只是一段文字。
GitHub：github.com/mantou132/A…
一分钟上手
在跑 agent 的电脑上装一个后台守护进程（Rust 写的 agentdeckd）：
npm install -g agentdeckd
agentdeckd start
手机装上 App（Google Play 搜 AgentDeck），扫码配对就能用。
内置了一个 Free agent（OpenCode 的免费模型），不需要任何账号或 API Key ，装完马上能试。
和其他同类工具有什么不一样
1. agent 知道自己在跟手机说话
App 连接时会告诉 daemon 自己能渲染什么（图表、地图、HTML 预览、实时画面……），daemon 把对应的能力以 skill 的形式交给 agent。于是 agent 不再输出一大段表格，而是直接给你一张能交互的图表：
agent 写的 HTML 页面也可以在手机上一键预览。
2. 在手机上看 agent 正在操作的模拟器
做移动端或前端的时候，agent 改完 UI 我最想知道的是「现在长什么样」。AgentDeck 可以实时查看 agent 正在驱动的 iOS 模拟器、Android 模拟器或浏览器标签页 ，不用回到电脑前：
3. 不绑定某一家 agent
daemon 基于 Agent Client Protocol（ACP），可以启动 Claude Code、Codex、Cursor、GitHub Copilot、OpenCode、Qwen Code、Kimi CLI 等 ACP 注册表里的 agent，在手机上切换 agent 和模型。
daemon 常驻后台、开机自启，不需要开着终端，也不需要用另一个命令包一层 claude。
4. 其他离开键盘时用得上的功能
- 手机上审批权限请求、回答 agent 的问题
- 任务完成推送通知
- 浏览文件、Git 改动、diff 和提交历史，检查 agent 到底干了什么
- 按住说话的语音对话，agent 每次回复结尾会朗读一段简短总结
- 可以让电脑在 agent 工作时不自动睡眠
- 还有 Chrome / Firefox 侧边栏扩展，建会话时自动带上当前标签页
连接和安全
手机和电脑都主动连到一个 WebSocket Relay，所以不用开端口、不用 VPN 。
二维码里的配对 ID 是一个 32 字节的密钥，两端用 HKDF-SHA256 派生出路由 ID 和双向密钥，所有消息用 XChaCha20-Poly1305 加密，Relay 只能看到派生的路由 ID 和密文。默认 Relay 由我托管，也可以自己部署：github.com/mantou132/r…
目前的不足
- 目前只有 Android，iOS 正在做
- 加密是预共享密钥，没有前向保密。拿到配对 ID 的人就能用你的 agent，请当成密码保管，泄露了用
agentdeckd reset轮换 - 各家 agent 的 ACP 适配器实现程度不同，部分功能会有差异
最后
项目完全开源，欢迎试用、提 issue、拍砖。特别想知道：
- 你最常用哪个 agent，希望我优先测哪个？
- 你在手机上最想看 agent 的什么产出？
GitHub：github.com/mantou132/A…
English / 原文
起因
我经常让 coding agent 跑一个比较长的任务，然后去干别的。回来一看，它五分钟前就卡在一个权限确认上，什么也没干。
市面上已经有不少「手机遥控 agent」的工具了，但用下来总觉得是把终端搬到手机上：一屏的文字和日志，在手机上很难看。于是我做了 AgentDeck ，想解决两件事：
- 离开电脑也能开会话、审批权限、收到完成通知；
- agent 的产出在手机上要好看、能直接看 ，而不只是一段文字。
GitHub：github.com/mantou132/A…
一分钟上手
在跑 agent 的电脑上装一个后台守护进程（Rust 写的 agentdeckd）：
npm install -g agentdeckd
agentdeckd start
手机装上 App（Google Play 搜 AgentDeck），扫码配对就能用。
内置了一个 Free agent（OpenCode 的免费模型），不需要任何账号或 API Key ，装完马上能试。
和其他同类工具有什么不一样
1. agent 知道自己在跟手机说话
App 连接时会告诉 daemon 自己能渲染什么（图表、地图、HTML 预览、实时画面……），daemon 把对应的能力以 skill 的形式交给 agent。于是 agent 不再输出一大段表格，而是直接给你一张能交互的图表：
agent 写的 HTML 页面也可以在手机上一键预览。
2. 在手机上看 agent 正在操作的模拟器
做移动端或前端的时候，agent 改完 UI 我最想知道的是「现在长什么样」。AgentDeck 可以实时查看 agent 正在驱动的 iOS 模拟器、Android 模拟器或浏览器标签页 ，不用回到电脑前：
3. 不绑定某一家 agent
daemon 基于 Agent Client Protocol（ACP），可以启动 Claude Code、Codex、Cursor、GitHub Copilot、OpenCode、Qwen Code、Kimi CLI 等 ACP 注册表里的 agent，在手机上切换 agent 和模型。
daemon 常驻后台、开机自启，不需要开着终端，也不需要用另一个命令包一层 claude。
4. 其他离开键盘时用得上的功能
- 手机上审批权限请求、回答 agent 的问题
- 任务完成推送通知
- 浏览文件、Git 改动、diff 和提交历史，检查 agent 到底干了什么
- 按住说话的语音对话，agent 每次回复结尾会朗读一段简短总结
- 可以让电脑在 agent 工作时不自动睡眠
- 还有 Chrome / Firefox 侧边栏扩展，建会话时自动带上当前标签页
连接和安全
手机和电脑都主动连到一个 WebSocket Relay，所以不用开端口、不用 VPN 。
二维码里的配对 ID 是一个 32 字节的密钥，两端用 HKDF-SHA256 派生出路由 ID 和双向密钥，所有消息用 XChaCha20-Poly1305 加密，Relay 只能看到派生的路由 ID 和密文。默认 Relay 由我托管，也可以自己部署：github.com/mantou132/r…
目前的不足
- 目前只有 Android，iOS 正在做
- 加密是预共享密钥，没有前向保密。拿到配对 ID 的人就能用你的 agent，请当成密码保管，泄露了用
agentdeckd reset轮换 - 各家 agent 的 ACP 适配器实现程度不同，部分功能会有差异
最后
项目完全开源，欢迎试用、提 issue、拍砖。特别想知道：
- 你最常用哪个 agent，希望我优先测哪个？
- 你在手机上最想看 agent 的什么产出？
GitHub：github.com/mantou132/A…