Agent 在 Mac 上，
你在手机上控。
Claude Code、Codex、OpenCode、Grok — 随时接入，秒级确认。
-
在电脑上装 server.
在 Mac / Linux 的终端里跑一行. 需要 tmux 3.2+ (安装器只检查, 不代装). Windows 在 PowerShell 跑一行, 不需要 tmux.
-
在手机上装 App.
App Store 下载 QuickTUI, iPhone 和 iPad 通用.
-
在手机上配对一次.
安装器显示二维码, 用 App 扫一下. 会话就在手机上了.
手机在手边, 电脑不在? 在 App 里添加服务器, 选「快速设置」, 填 SSH 登录信息, App 帮你把 server 装好.
获取应用 →
每天都会用到的功能。
专为手机与 iPad 设计的屏幕组件 — 切换标签查看每一项。
工具栏 与 方向键
可自定义底栏按键，外加方向键、Esc、Tab、Enter、退格、Home/End 等 — 一指即达。
输入条
工具栏上方的紧凑输入条。打开、输入、发送 — 不用时完全不挡路。
命令面板
可搜索的命令启动器，支持文件夹与最近列表。斜杠命令自动回车。
切换器
三指上滑在 tmux session / window 间跳转 — 跨电脑也行。
文件浏览器
在 App 内浏览、预览与下载电脑上的文件。每个 pane 记住上次目录。
指南
更深入的配置指南与产品对比。
常见问题。
六个最常被问到的问题。完整文档见 FAQ 专页。
macOS / Linux：会话后端为 tmux 3.2 或更高版本。安装器不会代装 tmux — 请用系统包管理器自行安装（brew、apt、yum、dnf 等）后重新运行安装器。
可选：将安装器环境变量 QUICKTUI_TMUX_BIN 或 TOML 键 tmux_bin 设为 tmux 绝对路径。注册服务时也可能把发现到的路径写入配置。
Windows：默认后端是 qscn，不是 tmux。安装器会自动把 qscn 装到 %LOCALAPPDATA%\QuickTUI\。
在 macOS/Linux 的 server 机器上运行 quicktui-server pairing qrcode；Windows PowerShell 运行 & "$env:LOCALAPPDATA\QuickTUI\quicktui-server.exe" pairing qrcode，再用原生 App 扫描短期有效的二维码。可加 --browser 显示像素二维码，使用 --select-address 选择地址，或在 TLS 后使用 --debug-addr https://your.domain。
当前 CLI 流程只支持能扫描二维码的原生 App 配对新设备，尚不提供 Web 或 Desktop 新设备配对所需的完整 payload 导出。配对会注册设备公钥并固定 server identity，不会创建或泄露 root token。
先检查服务：
# macOS launchctl print gui/$(id -u)/ai.quicktui # Linux systemctl --user status quicktui # Windows（计划任务；若没有则查 HKCU Run 回退） schtasks /Query /TN QuickTUI reg query "HKCU\Software\Microsoft\Windows\CurrentVersion\Run" /v QuickTUI
优先用 service restart / service uninstall（%LOCALAPPDATA%\QuickTUI\ 完整路径，覆盖两种 Windows 模式）。若跳过了服务注册，用相同配置和地址启动服务端。若已在运行，确认防火墙或隧道放通了 addr 对应端口。
QuickTUI 使用设备配对，不再使用 root 或 browser token 登录。每个客户端都会固定 server identity，并在当前 E2E 握手内用绑定 transcript 的 device_pop_v1 证明持有设备私钥。
直连会端到端承载 client-server E2E 隧道；QuickTUI Relay 只转发不透明的加密帧。Web 仅在 HTTPS 或 loopback origin 保存不可导出的设备密钥；远程明文 HTTP 会被拒绝。
旧 root-token profile 必须重新配对。旧版每设备 token 只能在固定 identity 的 E2E 内迁移一次，随后先完成新的 PoP 认证，再删除旧 token。用 quicktui-server pairing devices list 列出设备，用 quicktui-server pairing devices revoke <device_id> 撤销设备；Windows PowerShell 请使用 $env:LOCALAPPDATA\QuickTUI\quicktui-server.exe 完整路径。