FAQ
Quick answers to real questions.
Straight, practical answers to what people actually ask us — no fluff. Can't find yours? Reach out via Support.
Panes look narrow on my phone with a big crew / lots of empty space — why?
The phone renders exactly the tmux grid from the selected Mac terminal — nothing more, nothing less. If that Mac terminal window uses a large font, tmux fits fewer columns into it, and Termio faithfully shows that narrower content with room around it. Shrink the selected Mac terminal's font size (e.g. Cmd+- in Ghostty or Terminal.app) and tmux immediately gains columns in the same window space; switch machines in the picker when you need a different target. This isn't a phone-side setting — the source of truth is always the selected Mac's tmux grid.
macOS asks me to re-grant permissions after every update.
Fixed in 1.1.57 and later — the daemon's self-updater now swaps its binary atomically instead of overwriting it in place, so Accessibility and Screen Recording grants now survive updates. If you were affected by an earlier build, there's a one-time cleanup: open System Settings → Privacy & Security → Accessibility (and Screen Recording, if you use recording features), find Termio Status in the list, and toggle it off then back on — or remove it with the “-” button and relaunch Termio Status so macOS re-prompts you. If a permission is ever lost again, the menu bar app now shows a guided banner with a direct “Open Settings” button, so you don't have to hunt for the right pane yourself.
How do I pair my phone with my Mac?
On each Mac, open Termio Status from the menu bar and choose “Pair with Code…” — it shows a QR code plus an 8-character fallback code. On your phone, tap Add Mac, scan that Mac's QR (or enter its code manually), and repeat for other machines. Each Mac appears as its own target with its tmux panes; use the machine picker to switch between them.
First launch on the Mac seems stuck — nothing happens after I open the app.
That first launch is macOS itself, not Termio Status — before our code ever runs, Gatekeeper checks the developer certificate hasn't been revoked, which needs a brief network round-trip. On a normal connection this is usually instant; on a restrictive network, captive portal, or a DNS/firewall setup that blocks or intercepts Apple's certificate-check servers, macOS may wait out that check with no visible progress (no spinner, no dock bounce) rather than failing fast. It isn't specific to Termio and isn't something an app can shorten or skip: the wait happens before any app code, ours or anyone else's, gets to run. If it never opens, try a different network (e.g. phone hotspot) for the first launch only — after that, macOS remembers the app and every later launch is instant.
Is my terminal content private? What does crash reporting actually send?
Yes — the relay is a router, not a recorder: it never stores your terminal output, pane buffers, prompts, or agent responses. Crash reporting (Settings → “Share Crash Reports” on Mac, “Share anonymous diagnostics” on Android) is an opt-in toggle that sends only scrubbed diagnostics — app/OS version, the error name and stack trace, and, on Mac, the last 50 lines of the daemon's own log with your home directory and username stripped before anything is written or uploaded. It never includes terminal or pane content. Turn the toggle off any time to stop collection and upload immediately.
How do I update the Mac app, and where are the release notes?
Termio Status checks for updates automatically on each Mac and shows the current build right in that Mac's menu. Click “Check for Updates” any time to force a check, or “Download & Install” when a new version is ready — no separate download needed. Full release history for iOS, macOS, and Android lives at /changelog, the same catalog the app itself checks against.
What crew sizes are supported?
A crew supports 2 to 10 panes total — 1 manager plus 1 to 9 workers. This cap is enforced consistently everywhere a crew can grow (crew creation, add-worker, and the tmux-side crew tooling), so you'll see the same limit no matter which surface you use.
Still have a question?
Email support@termio.xyz — we read every message and typically reply within 2 business days.