Agent 在 Mac 上，
你在手机上控。
Claude Code、Codex、OpenCode、Grok — 随时接入，秒级确认。
每天都会用到的功能。
专为手机与 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 设为 tmux 绝对路径。注册服务时也可能把发现到的路径写入配置。
Windows：默认后端是 qscn，不是 tmux。安装器会自动把 qscn 装到 %LOCALAPPDATA%\QuickTUI\。
确保配置文件中有非空 token：
QUICKTUI_TOKEN=…
默认路径：~/.config/quicktui/config（Windows：%USERPROFILE%\.config\quicktui\config）。也可传 --token。serve 使用 flag > 配置文件；仅设置进程环境变量对普通 quicktui-server 进程不够。
先检查服务：
# 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
优先用 --restart-service / --uninstall-service（%LOCALAPPDATA%\QuickTUI\ 完整路径，覆盖两种 Windows 模式）。若跳过了服务注册，用相同 token 和地址启动服务端。若已在运行，确认防火墙或隧道放通了 QUICKTUI_ADDR 对应端口。
保存在 QUICKTUI_TOKEN 中的密钥 — 用于保护服务端 HTTP API 与浏览器登录。安装时设定（之后也可用安装器的 --token / --rotate-token）。在电脑上查看：
cat ~/.config/quicktui/config # 或 quicktui-server --dump-token
Windows 配置路径为 %USERPROFILE%\.config\quicktui\config，二进制通常在 %LOCALAPPDATA%\QuickTUI\quicktui-server.exe（若不在 PATH 请用完整路径）。浏览器客户端：打开 http://<host>:8022，按提示粘贴一次 access token。
原生 App 配对：不要粘贴 access token。在电脑上运行 quicktui-server --pair-qrcode（macOS/Linux）或 & "$env:LOCALAPPDATA\QuickTUI\quicktui-server.exe" --pair-qrcode（Windows），可选 --browser，再在 App 中扫描。配对使用 QR 内的短期 pairing code，不是 access token。