应用场景 · AI Agent

从手机操控 AI Agent

AI Agent 在有人盯着时表现最佳：把它们启动起来、批准有风险的步骤、在它们跑偏时拉回正轨。QuickTUI 把这份掌控放进你的口袋：在你自己的电脑上启动一个 Agent，然后通过一个真正的终端从手机上监督并引导它。

像 Claude Code 和 Codex 这样的 Agent 跑在终端里，工作耗时以分钟计，所以有用的问题不是"我能不能跟它聊天"，而是"我能不能从任何地方让它持续运行、让它守规矩"。QuickTUI 是原生 iPhone 和 iPad 应用（另有浏览器客户端），接入你自己托管的电脑上真正的 tmux，所以 Agent 一直活在机器上，而你从手机上驱动它。

启动并监督

• 发起一次运行。打开一个会话，启动 Agent，交给它一个任务，就是你在办公桌上会敲下的那段提示词。
• 批准并引导。盯着实时输出，批准工具调用、回答问题，并在 Agent 偏离时重新导向。你看到的是真正的终端，而非摘要。
• 充当会话保活。走开一会儿，这次运行会在电脑的 tmux 里继续。重新打开应用，会话保活会跨越 Wi-Fi 切 LTE 或 5G、应用切后台和连接中断，重新接回实时画面。

选择何时接收 Agent 通知

Agent 通知是可选功能，只有你在设备上授予通知权限并启用该设备的通知注册后才会开启。每台 server 再分别控制已注册设备会收到哪些待审批、任务完成、错误和会话结束类别。默认通知正文只说明事件；独立的字段开关可加入 Agent 类型、项目名、会话名及任务或错误摘要。

即使日常终端连接是直连，通知投递仍会使用 QuickTUI Relay 与 APNs 或 FCM。投递、去重和打开对应本机 profile/session/interaction 所需的 route-only 标识不受正文开关控制。数据流、留存边界和撤销方式详见隐私政策。

配置你的电脑

在你想运行 Agent 的机器上安装 QuickTUI。它会配置好服务。macOS/Linux 需自行安装 tmux 3.2+（安装器不代装 tmux）；Windows 会自动安装 qscn 会话后端。

curl -fsSL https://quicktui.ai/q.sh | sh

irm https://quicktui.ai/q.ps1 | iex

Windows 说明：会话后端是 qscn，不是 tmux。请在 App 里用 New Session 建会话；下文的 tmux new-session 示例适用于 macOS/Linux。

用下面的平台命令完成扫码配对。二维码会注册当前设备并固定 server identity，不需要输入 root token。连接默认直连，业务流量端到端加密。

# macOS / Linux
quicktui-server pairing qrcode

# Windows（PowerShell）
& "$env:LOCALAPPDATA\QuickTUI\quicktui-server.exe" pairing qrcode

适配任意 Agent

由于 QuickTUI 驱动的是真正的 tmux，它并不绑定单一工具。运行 Claude Code、Codex 或任意 CLI Agent，各自跑在独立的会话里，然后从手机上来回切换。

tmux new-session -s agent
claude   # or: codex, or any CLI agent

常见问题

我能操控哪些 Agent？

任何跑在终端里的 CLI Agent：Claude Code、Codex 或你自己的工具。QuickTUI 驱动的是真正的 tmux，所以它不局限于某个特定产品。

我能批准步骤并引导 Agent，而不只是读取输出吗？

能。你拿到的是实时终端，所以可以从手机上实时回答提示、批准工具调用，并重新导向 Agent。

我离开时 Agent 还会继续运行吗？

会。它跑在你电脑的 tmux 里，在你断开后仍会继续。会话保活会跨越网络切换、应用重启和连接中断，重新接回实时会话。

必须开启 Agent 通知吗？

不用。系统权限与设备通知注册是两项独立的主动开启控制，每台 server 另有 server-wide 通知偏好。你可以随时撤销权限、关闭设备注册或关闭 server 类别。