Install
Install QuickTUI on your machine
Two install paths, full installer options, gestures, and mirror notes.
Two install paths
SSH-capable machine → App wizard.
Add a server in the iOS app, pick Quick Setup, enter your SSH credentials. The app installs it on your machine for you, no terminal needed.
No SSH? Run on the machine.
macOS / Linux · Global
curl -fsSL https://quicktui.ai/q.sh | shWindows · PowerShell
irm https://quicktui.ai/q.ps1 | iexCopy that one line to the machine's terminal and run it. Done in under a minute.
China mirror.
curl -fsSL https://dl.quicktui.cn/q.sh | shThis is a parallel entrypoint for users in China. Existing installs from quicktui.ai/q.sh do not migrate automatically; re-run dl.quicktui.cn/q.sh to use OSS-backed automatic updates.
Windows machine? One line in PowerShell.
irm https://quicktui.ai/q.ps1 | iexDownloads the installer, installs the qscn session backend automatically, and registers a Scheduled Task that starts the service at logon. China mirror support for Windows arrives once qscn assets are mirrored. On legacy Windows PowerShell 5.1 with TLS 1.2 disabled, prepend [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor 3072; to the same line.
Pair the app, or open a browser.
On the machine, run quicktui-server --pair-qrcode, then in the app tap + → Scan. Add --browser to open the QR in your system default browser (desktop sessions). To pick a public address for the QR, use --list-addr or --addr <host:port|URL>. After install you can also re-open the pairing guide with quicktui-server --welcome.
Browser users: visit http://<host>:8022 and paste the access token once (browser login still uses the server token; app pairing uses a short-lived pairing code, not that token).
Device pairing ops.
List or revoke paired devices without restarting the daemon:
quicktui-server --list-paired-devices
quicktui-server --revoke-device <device_id>--rotate-server-identity rotates the E2E identity and clears all pairs; the service must be stopped first. Only use it when you intend to re-pair every device.
INSTALLER OPTIONS
Non-interactive installs, custom ports, environment checks. Pass via sh -s --:
| Option | Description |
|---|---|
-y, --yes | Non-interactive mode |
--token <string> | Set access token (default: prompted) |
--rotate-token | Generate a fresh random token |
--addr <address> | Listen host, host:port, or http(s)://host:port (default: 0.0.0.0). An IPv6 literal must be bracketed and carry its own port, e.g. [::1]:9000 |
--port <port> | Listen port, used when --addr has no port (default: 8022) |
--term <value> | TERM for tmux (default: xterm-256color) |
--lang <value> | LANG for tmux (default: en_US.UTF-8) |
--release | Install the latest stable server release (added by default when no channel option is given) |
--preview | Install the latest server preview release |
--publish-tag <tag> | Install that exact release tag straight from the release host, bypassing the manifest; overrides --release / --preview |
--check | Run environment checks without installing |
--no-service | Skip background service setup |
--uninstall | Stop the service and uninstall QuickTUI |
curl -fsSL https://quicktui.ai/q.sh | sh -s -- -y --port 9000GESTURES
How you actually drive the terminal from a phone or iPad. A few of these are swappable in Settings if you prefer single- and double-finger flipped.
| Gesture | Action |
|---|---|
| 1-finger double-tap | Send Tab |
| 2-finger double-tap | Send Enter |
| 1-finger swipe ↕ | Scroll history |
| 1-finger swipe ↔ | Switch tmux window |
| 2-finger swipe | Arrow keys |
| 3-finger swipe ← | Backspace |
| 3-finger swipe ↑ | Open session switcher |