Usage Guide

There are three ways to connect from the Connect screen:

• Manual — type the server URL (host:port) and paste a bearer token, then tap Connect, and pick a trust mode — Public domain (CA) for a CA-signed server, or Trust anyway (marked insecure) for development.
• QR scan — tap the FAB on the Connect screen to open the camera scanner. Scan a QR code generated by muxrctl; the connection is cert-fingerprint-pinned automatically with no further prompts.
• Saved-server pill — tap a saved server pill below the form to pre-fill its credentials. If a biometric-protected token is stored, a biometric prompt unlocks it for one-tap reconnect.

The Remember for 4 weeks toggle keeps the login valid for four weeks instead of the default few minutes.

The Sessions screen lists all running sessions on the connected server.

• Tap a session card — opens that session in the Terminal screen.
• Long-press a session card — shows a menu with options to rename or kill the session. Killing a session asks for confirmation before proceeding.

To create a new session, use the new-session affordance (the dashed “+ new session” button on phone, or the create button on the tablet sessions view) and enter a name in the dialog.

The terminal view renders all tiled and floating panes in the active tab. Touch gestures are mapped as follows:

Gesture	Target	Effect
Tap	An unfocused pane	Focus that pane (sends a FocusPane RPC)
Tap	The focused pane	Opens the soft keyboard for input
Double-tap	Any pane	Toggles server-side pane fullscreen (TogglePaneFullscreen RPC)
Long-press	Terminal text	Starts text selection — see Copy text below
Back gesture	—	Exits client-side immersive mode first; if not immersive, prompts to detach from the session

Copy text

Long-press any text in the terminal to select the word under your finger; keep holding and drag to extend the selection word by word. A small magnifier loupe floats above your finger while selecting, so your thumb never hides the text. Release to show a floating Copy chip — tap it to put the selected text on the system clipboard, or tap anywhere else to dismiss the selection.

Selection is entirely client-side (it reads the rendered terminal buffer, no server round-trip), so it works on every backend and even in read-only sessions.

The command center is the primary affordance for tab and pane management within the Terminal screen.

• Phone — a persistent FAB in the lower corner opens a modal bottom sheet.
• Tablet — a persistent 220 px left pane rail is always visible alongside the terminal.

From either the sheet or the rail:

• Tab pills — tap to switch to that tab (GoToTab RPC).
• + tab — adds a new tab.
• Pane rows — tap a pane row to focus it.
• New pane card — tap to create a tiled pane; long-press to create a floating pane.
• Long-press a tab or pane row — shows a contextual menu with rename and close options.

The Settings screen is divided into several groups:

• Connection info — shows the connected server endpoint, its TLS trust label, and the server/backend versions.
• Tokens — create new auth tokens and revoke existing ones on the server.
• Saved servers — manage saved server profiles and their biometric-protected credentials.
• Muxr Pro — shows your plan (Free or Pro) and opens the upgrade.
• Appearance — font family (downloadable from the server's font catalog), font size, cursor style, and the mac-option-as-meta toggle for Option key behavior on iOS/macOS.
• Bell notification — toggle terminal bell notifications on or off.
• In-app log viewer — access the talker log stream for diagnostics without leaving the app.
• Disconnect — detach from the current session and return to the Connect screen.